OpenTV ENTera & OpenTV Platform Documentation

Get the content authorisation token

Request

To get the content authorisation token that you need to request a licence to play back a content, send a POST request to:

https://<host>:<port>/ias/v2/content_token

Headers

  • authorization – bearer token that the client received at signon

  • nv-tenant-id – the tenant ID

Mandatory arguments

  • content_id – the ID of the content (in query)

  • type – must be device (in query)

Other arguments

None

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An unauthorised request returns an HTTP 401 status.

A forbidden request returns an HTTP 403 status.

If the specified content does not exist, the request returns an HTTP 404 status.

Example

{
   "content_token": {
      "typ": "string",
      "ver": "string",
      "exp": 0,
      "jti": "string",
      "device": {
         "drm": "string",
         "deviceUniqueId": "string",
         "ipAddress": "string",
         "model": "string",
         "accountId": "string"
      },
      "contentRights": [
      {
         "contentId": "string",
         "start": "2020-10-09T11:09:06.954Z",
         "end": "2020-10-09T11:09:06.954Z",
         "duration": 0,
         "storable": true,
         "sessionControl": {
            "groupId": "string",
            "sessionControlEnabled": true,
            "maxSessions": 0
         }
      }
      ]
   },
   "token_type": "string",
   "expires_in": 0,
   "access_token": {
      "typ": "string",
      "ver": "string",
      "exp": 0,
      "fixed_exp": 0,
      "tenantId": "string",
      "accountId": "string",
      "userId": "string",
      "deviceId": "string",
      "jti": "string",
      "geoBlockExempt": true,
      "countryCode": "string",
      "sessionControl": {
         "groupId": "string",
         "sessionControlEnabled": true,
         "maxSessions": 0
      },
      "accountProfileId": "string",
      "billingCountryCode": "string",
      "onNetwork": true
   },
   "refresh_token": {
      "typ": "string",
      "ver": "string",
      "exp": 0,
      "fixed_exp": 0,
      "tenantId": "string",
      "accountId": "string",
      "accountProfileId": "string",
      "userId": "string",
      "deviceId": "string",
      "jti": "string",
      "sessionControl": {
         "groupId": "string",
         "sessionControlEnabled": true,
         "maxSessions": 0
      }
   }
}

See also

For full details of this API, see the IAS API documentation.