Playlists
Last updated
Last updated
Playlists are are collection of VoD assets that can be used to create the input for Serverside.ai VoD channels. Additionally the playlist items can hold the information for ad markers.
If you want to have pre roll ads simply create a ad with the start position at 0 seconds.
GET
https://admin.serverside.ai/api/v2/playlists
Listing all playlists
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
POST
https://admin.serverside.ai/api/v2/playlists
Create a playlist
GET
https://admin.serverside.ai/api/v2/playlists/:id
Retrieve a playlist entry
PUT
https://admin.serverside.ai/api/v2/playlists/:id
Update one playlist entry
DELETE
https://admin.serverside.ai/api/v2/playlists/:id
Delete one playlist entry
As a shortcut you do not necessarily need to create a database entry in order to support a simple playlist.
GET
http://admin.serverside.ai/api/unsecured-v2/playlists/generate
Automatically
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
offset
number
Start with item "offset" of the list (default: 0)
limit
number
Entries pert page. (default: 20 - maximum: 100)
x-api-key
string
x-api-key
string
id
string
unique identifier (an uuid v4 will be created if not provided)
contents[].cuePoints[].maxDuration
number
duration in seconds (float: e.g. 10 or 10.1234)
contents[].cuePoints[].maxAds
number
maximum number of ads
contents[].cuePoints[].spliceTime
number
in seconds or percent, depending on spliceType
contents[].spliceType
string
'seconds' or 'percent'
contents[].duration
number
e.g. 42.42 (in seconds)
contents[].url
string
only for sourceType 'url' url of the hls or dash VoD manifest
contents[].sourceType
string
'url' or 'placeholder'
type
string
'vod2live' or 'vod'
name
string
status
string
'enabled' or 'disabled' (defaults to 'disabled')
id
string
id of playlist
content
string
url to content that will be replaced if the content is from sourceType 'placeholder'
format
string
'mrss' or 'json'
accept
string
to get MRSS: appliation/rss+xml
x-api-key
string
id
string
id of the playlist
status
string
'enabled' or 'disabled' (defaults to 'disabled')
name
string
type
string
'vod2live' or 'vod'
contents[].sourceType
string
'url' or 'placeholder'
contents[].url
string
only for sourceType 'url'. URL of the HLS or DASH VoD manifest
contents[].duration
string
e.g. 42.42 (in seconds)
contents[].spliceType
string
'seconds' or 'percent'
contents[].cuePoints[].spliceTime
number
in seconds or percent, depending on spliceType
contents[].cuePoints[].maxDuration
number
duration in seconds (float: e.g. 10 or 10.1234)
contents[].cuePoints[].maxAds
number
maximum number of ads number of ads
id
string
id of playlist
packaging
string
'hls' or 'dash'
format
string
'mrss' or 'json' - defaults to 'json'
markers
string
colon ";" separated list of ad-marker in the format: <seconds>,<maxAds>,<maxDuration> (e.g. 0,2,20;90,1,30)
content
string
url of the content to create a playlist from