Abrufen von Videodaten

Dieses Thema zeigt eine Reihe von Beispielanfragen mit der HTTP GET-Methode.

Einleitung

In diesem Thema erfahren Sie, wie Sie mithilfe von verschiedene Arten von Informationen zu Ihren Video Cloud-Videos abrufen CMS API Anfragen. Um diese Anforderungen zu erstellen, hängen Sie die in diesem Dokument aufgeführten Endpunkte mit Ihrer Konto-ID an die Basis-URL an.

    https://cms.api.brightcove.com/v1/accounts/{account_id}/{endpoint}
    
    

Anfragen an die CMS API benötigen einen Autorisierungsheader, der Ihre Zugriffstoken enthält. Ausführliche Informationen zum Abrufen von Client-Anmeldeinformationen und deren Verwendung zum Abrufen von Zugriffstoken finden Sie im Übersicht über Brightcove OAuth.

Videos abrufen

Rufen Sie Daten für alle Videos in Ihrem Video Cloud-Konto ab.

Endpunkt: /videos

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos
    
    

Antwort

[
  {
    "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"
  }, ...
]

Holen Sie sich ein Video

Abrufen von Daten für ein bestimmtes Video oder mehrere Videos nach ID

Endpunkt: /videos/{video_id}[,{video2_id},{video3_id}]

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001
    
    

Antwort

    {
    "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
    }, ...
    
    

GET-Quellen

Rufen Sie die Quellen für ein bestimmtes Video ab.

Endpunkt: /videos/{video_id}/sources

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/sources
    
    

Antwort

    [
    {
    "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"
    }, ...
    ]
    
    

Bilder abrufen

Rufen Sie die Bilder für ein bestimmtes Video ab.

Endpunkt: /videos/{video_id}/images

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/images
    
    

Antwort

    {
    "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"
    }
    }
    
    

Video abrufen von refid

Rufen Sie die Daten für ein bestimmtes Video mithilfe der Referenz-ID ab.

Endpunkt: /videos/ref:{video_reference_id}

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7
    
    

Antwort

    {
    "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
    }, ...
    
    

GET-Quellen von refid

Rufen Sie die Quellen für ein bestimmtes Video mithilfe seiner Referenz-ID ab.

Endpunkt: /videos/ref:{video_reference_id}/sources

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/sources
    
    

Antwort

    [
    {
    "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"
    }, ...
    ]
    
    

GET Bilder von refid

Rufen Sie die Bilder für ein bestimmtes Video mit seiner Referenz-ID ab.

Endpunkt: /videos/ref:{video_reference_id}/images

Anfrage

    https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/images
    
    

Antwort

    {
    "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"
    }
    }