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