Endpoint Set API
watch.meta.endpoint_set
This API returns to the client (streaming application), an exhaustive list of all the API endpoints that will be needed to build a seamless integration.
Headers
The authorization header must carry the API key that was provided during application registration.
| Header | Value |
|---|---|
| Authorization | Bearer api_key |
| ClientID | platform-\<id>-app_version-\<id> |
The ClientID header is required, and this endpoint reads it: the platform and app version it carries decide which version of the swimlane and playback endpoints you are given. It must have four hyphen-separated components, and the first must be one of web, roku, firestick, fireos, appletv, ipad, tizen.
Endpoint
GET v2/watch/meta/endpoints
Response Body
{
"endpoints": {
"watch.meta.product.retrieve": "v2/watch/meta/product-config",
"watch.auth.session.login": "v2/watch/auth/login",
"watch.content.project.list": "v2/watch/content/projects",
"watch.stream.session.playback": "v4/watch/stream/<str:screener_key>/playback"
},
"host": {
"name": "https://api.indee.tv/"
},
"status_code": "W0000",
"status_message": "Success"
}
| Field | Type | Description |
|---|---|---|
endpoints |
JSON | A map of canonical endpoint name to the path for that endpoint. |
host |
JSON | The host configuration for the API. |
host.name |
String | The base server URL to prepend to each endpoint path. |
status_code |
String | The Indee status code for the response. |
status_message |
String | Human readable message describing the response. |
Some entries vary by caller. The swimlane and playback paths are chosen from the platform and app version in your ClientID header, so an older app is given an older version of those endpoints and a newer one is given the latest.
Status Codes
| Indee status code | HTTP Response Code | Description |
|---|---|---|
| W0000 | HTTP 200 | Success |
| W2000 | HTTP 401 | Authorization header was either not passed or there was some issue parsing it |
| W2001 | HTTP 401 | API key is invalid or expired, or is not fully configured |
| W2009 | HTTP 401 | ClientID header was either not passed or is malformed |
| W2100 | HTTP 403 | Origin domain is not whitelisted for this API key |
| W2108 | HTTP 403 | Watch product is inactive |
| W2102 | HTTP 451 | Request blocked by geofencing for the resolved region |
| W5001 | HTTP 429 | Rate limited |
| W5000 | HTTP 500 | Unknown server error occurred |