La première étape pour l'utilisation de l'API de gestion des playlists consiste à récupérer un token valable 24h à l'aide de la requête suivante et des informations de connexion qui vous auront été communiquées.
curl --location 'https://www.ultimedia.com/api/video/auth' \
--header 'Content-Type: application/json' \
--data '{
"login":"xxx",
"pwd":"xxxx",
"key":"xxxx"
}'
{
"token": "xxxxxx"
}
La requête suivante vous permet de récupérer l'intégralité des noms de playlists, de leurs IDs et du nombre de vidéos qu'elles contiennent pour l'ensemble de votre société :
curl --location 'https://www.ultimedia.com/api/video/playlist' \
--header 'Authorization: Bearer <VALEUR DE TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"action":"list"
}'
{
"success": true,
"data": [
{
"id": "xxx",
"name": "xxx",
"videos": 10
},
{
"id": "xxx",
"name": "xxxxx",
"videos": 20
}
]
}
La requête suivante vous permet de récupérer l'intégralité des vidéos et métadonnées associées qui sont contenues dans une playlist d'ID donné.
curl --location 'https://www.ultimedia.com/api/video/playlist' \
--header 'Authorization: Bearer <VALEUR DE TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"action":"list",
"playlist_id": "xxxxx"
}'
{
"success": true,
"data": [
{
"video_id": "xxx",
"title": "xxxx",
"description": "xxx",
"image": "xxxx",
"position": "2"
},
{
"video_id": "xxxx",
"title": "xxxx",
"description": "xx",
"image": "xxx",
"position": "1"
}
]
}
La requête suivante vous permet d'ajouter une vidéo en première position d'une playlist :
curl --location 'https://www.ultimedia.com/api/video/playlist' \
--header 'Authorization: Bearer <VALEUR DE TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"action":"add",
"playlist_id": "xxxx",
"video_id": "xxxx"
}'
{
"success": true
}
La requête suivante vous permet de supprimer une vidéo d'une playlist :
curl --location 'https://www.ultimedia.com/api/video/playlist' \
--header 'Authorization: Bearer <VALEUR DE TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"action":"remove",
"playlist_id": "xxxx",
"video_id": "xxxx"
}'
{
"success": true
}