Setting up an OTT session

A client application must set up a new OTT session before starting playback. After a session has been successfully set up, the device may begin playing the content.

Request

To set up a new OTT session, send an HTTP POST request to:

http://<host>:<port>/{frontEndAddress}/{tenantId}/ssm/v1/sessions/setup

Headers

• nv-authorizations – the request authorisation token. It can either be an SSP content authorisation token or an SSP device authentication token.

Response

A successful response returns an HTTP 200 status. The response body contains:

• The heartbeat period, in seconds (that is, how often the application must send a keep-alive request)

• The SSP session token to be used in the next request

Example

{
  "heartBeat": 30,
  "sessionToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2ZXIiOiIxLjAiLCJkZXZpY2VJZCI6IjViNTg2NTFkYTRhNWQ1MDAwMWZkMGI2MCIsInRlbmFudElkIjoibmFncmEiLCJleHAiOjI1MjQ2MDgwMDAsImFjY291bnRJZCI6ImFjY291bnRJZDEiLCJqdGkiOiI0ZTU3NTExNi02N2Y0LTQ0MjEtOGNjMC04Yzc3NjljNWE0ZmIiLCJ0eXAiOiJEZXZBdXRoTiJ9.sfgCwsBGWG87UCZHDfAa-WnpD8yVopOxds8qkO2GJXA"
}

See the API documentation below for the full list of return codes.

See also

For full details of this API, see Secure Session Management and Secure Session Manager (API documentation) in the SSP documentation.

.