Personas/Add-On Endpoints

From MozillaWiki
Jump to: navigation, search

Installation/Preview

All installations and previews rely upon a 'persona' attribute on the element the preview or install event is triggered on. This attribute is a JSON blob urlencoded with the following properties:

  • id
    • String
    • Unique identification for persona
  • name
    • String
  • header
    • String
  • footer
    • String
  • category
    • String
  • description
    • String
  • author
    • String
    • 'Pretty' username, used in place of username if not empty
  • username
    • String
    • Login for getpersonas.com
  • detailURL
    • String
    • Link to persona detail page
  • headerURL
    • String
    • URL to header image
  • footerURL
    • String
    • URL to footer image
  • previewURL
    • String
    • URL to thumbnail of persona
  • accentcolor
    • string
    • background color (hex) for personas
  • textcolor
    • string
    • text color (hex)
  • iconURL
    • String
    • URL to 32x32 icon of persona
  • updateURL
    • String
    • URL to json object with the persona's metadata. Used to check once/day for updates to the persona.

Summary list

http://www.getpersonas.com/static/index_1.json - used to populate the menu with personas.

Individual Persona JSON

http://www.getpersonas.com/static/0/8/74008/index_1.json - not sure what it's used for

User Favorites

http://www.getpersonas.com/en-US/gallery/All/Favorites?json=1 - used to fetch user's favorites, only if logged in. Add-on knows if user is logged in if there is a cookie from getpersonas.com named 'PERSONA_USER'.