Migrating to the new PlayableStream format endpoints
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 is non-normative and is just a suggestion
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
}
}
]
}