Walk through use case
Using the old endpoint
Currently the client will call our "play" endpoint which returns an JSON object containing the URL where the stream is available and the DRM information required to play it.
Using the new endpoint
Our new endpoint PlayableStream related to Channel (live) returns similar information, but is more detailed.
The chief differences to note are:
- The startover parameter is renamed to "restart_at_beginning"
- The following parameters are no longer required or supported:
- service
- ajax
- stream_type
- The API will return a number of different stream_types and let the client pick which one to display
- The "suggested_devices" key in the response will be empty until we implement this feature. We will be linking transcode profiles to these suggestions to allow creating streams that are better suited for specific devices. Currently this is planned for H2 2018
This is an actual example returned for an npvr stream. Note that the protection type does not require protection keys so this is omitted in this response.
Please refer to the API documentation for a more general response.
Response structure
{
"data":[
{
"id":"{"stream_url":"https://pre-npvr-media-booxmedia.secure.footprint.net","profile_name":"sd_1"}",
"type":"PlayableStream",
"attributes":{
"suggested_devices":[
],
"codec_info":"video/mp4",
"transport_protocol":"https",
"streaming_protocols":[
"hls"
],
"bitrate":2404,
"stream_url":"https://pre-npvr-media-booxmedia.secure.footprint.net/data/r1/2018/04/06/17/6081372/6081372.ism/playlist.m3u8?startvalidity=20180406115952&endvalidity=20180407120452&nva=20180407120452&ttl=86700&ip=81.157.251.100&token=0f2636a5df2905e026323",
"protection_types":[
"cdn_auth_token1"
],
"profile_name":"sd_1",
"max_resolution":"576",
"vbr_max_bitrate":2404
}
},
{
"id":"{"stream_url":"http://mts-pre-vdn-sslsegments.dna.fi","profile_name":"sd_1"}",
"type":"PlayableStream",
"attributes":{
"suggested_devices":[
],
"codec_info":"video/mp4",
"transport_protocol":"http",
"streaming_protocols":[
"hls"
],
"bitrate":2404,
"stream_url":"http://mts-pre-ew3020-van-1-1.dna.fi:80/session/b66c06bc-3992-11e8-b6e0-00505699e137/7kcjqi/data/r1/2018/04/06/17/6081372/6081372.ism/playlist.m3u8?token=de0f08e0e63b388aae976bb96a8b4aae_1523045092_1523045092",
"protection_types":[
"cdn_edge"
],
"profile_name":"sd_1",
"max_resolution":"576",
"vbr_max_bitrate":2404
}
}
]
}