簡介
CMS和 Playback API可以訪問您的 Video Cloud 視頻數據。 本主題的目的是幫助您了解它們之間的區別以及使用它們的最佳實踐。
CMS和 Playback APIs
CMS和 Playback API訪問相同的基礎視頻數據。 它們之間存在一些關鍵差異,這些差異應決定在特定情況下使用哪種。
一般來說, CMS API 適用於後端使用,例如集成 Video Cloud 與您的CMS系統配合使用。 的 Playback API 用於前端以獲取視頻和播放列表數據 player或視頻門戶網站( Brightcove Player catalog
以及 playlist
API使用 Playback API, 例如)。
下表列出了這兩個API之間的一些主要區別。
項目 | CMS API | Playback API |
---|---|---|
操作種類 | 創建,讀取,更新,刪除 | 只讀-無法使用以下命令修改數據 Playback API |
經營範圍 | 管理視頻數據的各個方面 | 提取特定的視頻或播放列表,或搜索視頻 |
認證 | 臨時 訪問令牌 | 永久 策略密鑰 |
數據新鮮度 | 無緩存,始終為最新 | 緩存長達20分鐘 |
反應速度 | 慢點 | 更快(由於緩存) |
點擊造訪 | 僅服務器端(禁用COR) | 服務器或客戶端(啟用COR) |
數據 | 視頻和播放列表請求不包含視頻源URL; 需要第二個請求才能得到那些 | 視頻和播放列表請求確實包含視頻源URL |
使用媒體網址
重要的是要理解,演繹,圖像和其他資產的URL不是固定的。 Brightcove會不時重新配置媒體資產的存儲,當這種情況發生時,特定資產的URL將會更改。 如果您依靠頁面或應用程序中這些資產的硬編碼URL,則鏈接有時會斷開。
此外,所有網址都包含一個 TTL
出於內容安全原因的令牌。 這意味著默認情況下,URL在6小時後過期。 令牌的壽命可以延長到365天-如果您希望更長的時間,lived個令牌, 聯繫Brightcove支持。 但是請注意, TTL
反映了CDN將緩存資產的最長時間,但不能保證URL在令牌到期之前不會更改。
防止斷開與媒體的鏈接的最佳方法是從 Video Cloud 在運行時使用 CMS API 或者 Playback API.
緩存網址
如果不能選擇運行時API請求,那麼我們建議從本地數據緩存中獲取URL,該URL至少每天一次或在更新後的時間內刷新一次live 為您的 TTL
令牌,以較短者為準。
參考編號衝突
本部分適用於 CMS API 只。
為了確保參考ID的唯一性, CMS API 對分配給視頻的視頻進行任何操作後,最多可將ID鎖定3分鐘。 當您嘗試重試失敗太快的請求時,或者在刪除先前分配給它的視頻後不久嘗試重用參考ID時,這可能會導致返回409錯誤。 見 錯誤消息參考 更多的細節。