Introduction
Dans cette rubrique, vous apprendrez comment récupérer différents types d'informations sur vos vidéos Video Cloud, à l'aide de CMS API requêtes. Pour créer ces demandes, ajoutez les points de terminaison répertoriés dans ce document à l'URL de base avec votre identifiant de compte.
https://cms.api.brightcove.com/v1/accounts/{account_id}/{endpoint}
Les demandes à l' CMS API exigent un en-tête d'autorisation qui contient vos jetons d'accès. Pour plus de détails sur la façon d'obtenir les informations d'identification client et de les utiliser pour récupérer des jetons d'accès, consultez le Présentation de Brightcove OAuth.
OBTENIR des vidéos
Récupérez les données de toutes les vidéos de votre compte Video Cloud.
Point final : /videos
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos
Réponse
[
{
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Pre-roll",
"type" : "AD",
"time" : 0.0,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Bird Back",
"type" : "CODE",
"time" : 5.938,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Post-roll",
"type" : "AD",
"time" : 8.242,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
} ],
"custom_fields" : {
"customfield1" : "Approved",
"customfield2" : "Verified"
}, ...
]
OBTENIR une vidéo
Récupérer les données d'une vidéo spécifique ou de plusieurs vidéos par identifiant
Point final : /videos/{video_id}[,{video2_id},{video3_id}]
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001
Réponse
{
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Pre-roll",
"type" : "AD",
"time" : 0.0,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Bird Back",
"type" : "CODE",
"time" : 5.938,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, ...
OBTENIR des sources
Récupérez les sources d'une vidéo spécifique.
Point final : /videos/{video_id}/sources
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/sources
Réponse
[
{
"asset_id": "5164827527001",
"remote": false,
"src": "https://brightcove.vo.llnwd.net/e2/hls/57838016001/57838016001_5164827527001_5164799982001.m3u8?pubId=57838016001&videoId=5164799982001",
"type": "application/vnd.apple.mpegurl"
},
{
"asset_id": "5164827527001",
"remote": false,
"src": "https://brightcove.hs.llnwd.net/e2/hls/57838016001/57838016001_5164827527001_5164799982001.m3u8?pubId=57838016001&videoId=5164799982001",
"type": "application/vnd.apple.mpegurl"
}, ...
]
OBTENIR des images
Récupérez les images d'une vidéo spécifique.
Point final : /videos/{video_id}/images
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/images
Réponse
{
"thumbnail" : {
"id" : "3815806023001",
"src" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/273/1507807800001_3815782921001_still.jpg?pubId=1507807800001"
}
}
OBTENIR la vidéo par refid
Récupérez les données d'une vidéo spécifique à l'aide de l'identifiant de référence.
Point final : /videos/ref:{video_reference_id}
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7
Réponse
{
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, ...
OBTENIR des sources par refid
Récupérez les sources d'une vidéo spécifique à l'aide de son identifiant de référence.
Point final : /videos/ref:{video_reference_id}/sources
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/sources
Réponse
[
{
"asset_id": "5192219618001",
"remote": false,
"src": "https://brightcove.vo.llnwd.net/v1/uds/pd/57838016001/201611/3753/57838016001_5192219618001_5192207668001.mp4?pubId=57838016001&videoId=5192207668001",
"codec": "H264",
"container": "MP4",
"encoding_rate": 1823000,
"duration": 41237,
"height": 540,
"width": 960,
"size": 9417086,
"uploaded_at": "2016-11-01T09:37:37.336Z"
},
{
"asset_id": "5192219618001",
"remote": false,
"src": "https://brightcove.hs.llnwd.net/v1/uds/pd/57838016001/201611/3753/57838016001_5192219618001_5192207668001.mp4?pubId=57838016001&videoId=5192207668001",
"codec": "H264",
"container": "MP4",
"encoding_rate": 1823000,
"duration": 41237,
"height": 540,
"width": 960,
"size": 9417086,
"uploaded_at": "2016-11-01T09:37:37.336Z"
}, ...
]
OBTENIR des images par refid
Récupérez les images d'une vidéo spécifique à l'aide de son identifiant de référence.
Point final : /videos/ref:{video_reference_id}/images
Requête
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/images
Réponse
{
"thumbnail" : {
"id" : "3815806023001",
"src" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/273/1507807800001_3815782921001_still.jpg?pubId=1507807800001"
}
}