There's a bunch of APIs for fireplace that are very fireplace specific. This calls are things that we don't expect other clients to make and are formatting their response in a way that we wouldn't normally expect. This makes it hard for fireplace, we can't change things quickly and hard for clients who expect things to happen in a certain way (the GET /apps/app/...) for example. Another is the home page (http://firefox-marketplace-api.readthedocs.org/en/latest/topics/home.html#get--api-v1-home-page-) which is returning a result exactly the way fireplace wants. If that design changes, we shouldn't change the api.
URLs that I think we should move:
/home/page/ > /fireplace/home/
/apps/app/(int:id)|(str:slug) > /fireplace/app/(int:id)|(str:slug) *
/search/featured/ > /fireplace/search/featured/
** /apps/app/ will stay where it is, its just that /fireplace/app/ will have the more expanded result that fireplace wanted (users, upsell etc)
* /apps/rating/ contains user information, I'm tempted to fork it similar to /apps/app/
We'll need to move documentation and make clear that whilst clients can use this, we won't be worrying about changing things rapidly as the fireplace client needs change.