ioio.tv APIs

# Dash Variants

API call format

GET /broker/vod/list/<source_guid>/dash

Description

Get Master Dash playlist by GUID. This call gets encoded formats (variants) for DASH codec only. All variant with available bitRate,width and height are listed.

Precondition:

  • No authorization token is needed.
  • Mandatory elements (should be specified):
    • <source_guid> - valid source guid. Take a specific source guid using Vod list API call .

Postcondition

  • On success response code should be 200
  • On success the whole JSON body of the available DASH encoded formats is returned.
  • On failure an error will be returned with the right error code and description.

Example:

[Request] GET https://<base_api_url>/broker/vod/list/<source_guid>/dash`

[Request Headers] {"Content-Type":"application/json","Accept":"application/json","Authorization":"<IdToken>"}
[Response] 200
[Response Headers] {"Content-Type":["application/json"],"Content-Length":["..."],"Connection":["keep-alive"],"Date":["..... GMT"],"x-amzn-RequestId":["....."],....]}
[Response] 
{
  "status": true,
  "data": {
      "destBucket": "<vod-destinationbucket>",
      "mediaType": "dash_master",
      "guid": "<source_guid>",
      "variants": [
        {
          "width": 1280,
          "mediaType": "dash_playlist_720_2500000", //<dash_playlist_media_type>
          "bitRate": 2500000,
          "cdnUrl": "https://<server>/sources/<source_guid>/dash/<dashName>_720pinit.mp4",
          "height": 720,
          "filePath": "<source_guid>/dash/<dashName>_720pinit.mp4"
        },
        {
          "width": 940,
          "mediaType": "dash_playlist_540_1900000", //<dash_playlist_media_type>
          "bitRate": 1900000,
          "cdnUrl": "https://<server>/sources/<source_guid>/dash/<dashName>_540pinit.mp4",
          "height": 540,
          "filePath": "<source_guid>/dash/<dashName>_540pinit.mp4"
        },
        {
          "width": 640,
          "mediaType": "dash_playlist_360_1200000", //<dash_playlist_media_type>
          "bitRate": 1200000,
          "cdnUrl": "https://<server>/sources/<source_guid>/dash/<dashName>_360pinit.mp4",
          "height": 360,
          "filePath": "<source_guid>/dash/<dashName>_360pinit.mp4"
        },
        ....
      ],
      "cdnUrl": "https://<server>/sources/<source_guid>/dash/<dashName>.mpd",
      "filePath": "<source_guid>/dash/<dashName>.mpd",
      "dashPath": "<vod-destinationbucket>/sources/<source_guid>/dash/sources/<dashName>.mpd",
      "dashName": "<dashName>.mpd"
    }
}

We shall keep a variant mediaType for the next API calls.

← Dash Details →