App Navigation – Get Shelf List
This API returns the Shelves/Strips for the apps to display. The shelves are returned in the order that they should appear on the screen (vertically). If SUBSCRIBER_ID is provided in the request, then the returned list of shelves will be personalized recommended shelves for that subscriber. If a generic listing is required (e.g. for a guest user with no subscriber-id) then reserved value “FREE” should be used for SUBSCRIBER_ID.
Each shelf in the response has a given name (to be displayed as Shelf title in the app) and a URL for the corresponding feed. The “type” of the shelf can be as follows:
- “JTV_LEAF” (a static feed)
- “JTV_RECOMMENDED” (a dynamically generated feed created by the personalization/recommendation engine).
- “JTV_CONTINUE_WATCH” (displays a list of movies which are yet to be completed watching)
- “JTV_MY_FAV” (displays list of movies the user has added to favorite list)
Resource URL
Header Paramater
Authorization
requiredForm Parameter
device
optionalExample Request URL
Example Return
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
[ { "id": 1, "name": "Home", "description": "home", "poster": "", "parentId": 0, "type": "JTV_NODE", "url": "", "sub_shelves": [ { "id": 75, "name": "Work Hard, Play Hard!", "description": "workhardplayhard", "poster": "", "parentId": 1, "type": "JTV_LEAF", "sub_shelves": [], "url": "http://demo.junctiontv.net/metax/2.1/feed/filter/max/json/category?device=ipad&srh=work_play&limit=0" }, { "id": 63, "name": "New On The Channel", "description": "newonthechannel", "poster": "", "parentId": 1, "type": "JTV_LEAF", "sub_shelves": [], "url": "http://demo.junctiontv.net/metax/2.1/feed/filter/max/json/category?device=ipad&srh=new_channel&limit=0" }, …….. ] } |
The response of a invalid authorization access call ( Status #401) will look as follows:-
|
1 2 3 4 5 |
{ result: "error", message: "UNAUTHORIZED", reason: "No Authorization Token" } |
To see how to get access token - (see Getting Access Tokens)
The response of an ERROR in authorization access call ( Status #404) will look as follows:-
HTTP Status 404
