Retrieves information about public-facing playlists for use by a player.
Request
Request syntax:
https://content.uplynk.com/api/v4/player/owners/{user_id}/playlists
Response
The response for a successful request contains a list of the following parameters:
Response Parameter | Type | Description |
---|---|---|
@id | String | The URL containing the Playlist ID (has to be unique for the items returned) |
@type | String | Always set to "Playlist" |
id | String | The Playlist ID by itself |
desc | String | The name of the playlist |
total_duration | Integer | Duration of the playlist including optional ad breaks in seconds |
timeline_duration | Integer | Duration of the playlist not including optional ad breaks in seconds |
poster_url | String | The URL of the poster art |
url | String | The URL of the playlist without playback token (better to use this than @id) |
Sample Response
The following sample response contains information about the list of public-facing playlists.
{
"@id": "/api/v4/player/owners/0933a56ee6f5434c8ffe5e0099999999/playlists",
"@type": "Collection",
"items": [
{
"@id": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/d2ca1b9e717242908e42afe8f2f11263",
"@type": "Playlist",
"id": "d2ca1b9e717242908e42afe8f2f11263",
"desc": "Main Playlist",
"total_duration": 6116,
"timeline_duration": 5126,
"poster_url": "http://cf.cdn.uplynk.com/ause2/playlists/d2ca1b9e717242908e42afe8f2f11263/posters/tmpx8h_ewy6.jpg",
"url": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/d2ca1b9e717242908e42afe8f2f11263"
},
{
"@id": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/516184ef80be442697d0c14abfd87c99",
"@type": "Playlist",
"id": "516184ef80be442697d0c14abfd87c99",
"desc": "Test Playlist",
"total_duration": 1584,
"timeline_duration": 1554,
"poster_url": "http://cf.cdn.uplynk.com/ause1/playlists/516184ef80be442697d0c14abfd87c99/posters/tmpkdbnkfkv.jpg",
"url": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/516184ef80be442697d0c14abfd87c99"
},
}