サポート サポート問い合わせ先 | システムステータス システムステータス
ページ内容

    ベストプラクティス:CMSおよびPlayback API

    このトピックでは、カタログAPI(CMSおよび Playback API秒)。

    賃貸システムの概要

    CMSと Playback APIあなたの Video Cloud ビデオデータ。 このトピックの目的は、それらとその使用に関するベストプラクティスの違いを理解するのに役立ちます。

    CMSと Playback APIs

    CMSと Playback API同じ基本ビデオデータにアクセスします。 ただし、特定の状況でどちらを使用するかを決定する重要な違いがいくつかあります。

    一般に、 CMS API バックエンドでの使用を目的としています。 Video Cloud あなたのCMSシステムで。 ザ Playback API フロントエンドでビデオとプレイリストのデータを取得することを目的としています playersまたはビデオポータル( Brightcove Player catalogplaylist APIは Playback API、 例えば)。

    以下の表は、2つのAPIの主な違いを示しています。

    CMS対再生
    品目 CMS API Playback API
    オペレーションの種類 作成、読み取り、更新、削除 読み取り専用 - このデータを使用してデータを変更することはできません。 Playback API
    オペレーションの範囲 ビデオデータのあらゆる面を管理する 特定の動画や再生リストを取得するか、動画を検索する
    認証 一時的な アクセストークン 正社員 ポリシーキー
    データの新鮮さ キャッシングなし、常に最新 20分までキャッシュされる
    レスポンスのスピード もっとゆっくり より速く(キャッシングのため)
    アクセス サーバー側のみ(CORは無効) サーバー側またはクライアント側(CORが有効)
    データ 動画や再生リストのリクエストには動画のソースURLは含まれません。 それらを得るために2番目の要求が必要です 動画と再生リストのリクエストには動画のソースURLが含まれます

    メディアURLの使用

    レンディション、画像、およびその他のアセットのURLは固定されていないことを理解することが重要です。 ブライトコーブはメディアアセットのストレージを時々再構成します。これが発生すると、特定のアセットのURLが変更されます。 ページまたはアプリでこれらのアセットへのハードコーディングされたURLに依存している場合、リンクはある時点で壊れます。

    さらに、すべてのURLには TTL コンテンツのセキュリティ上の理由からトークン。 これは、URLがデフォルトで6時間後に失効することを意味します。 トークンの存続期間は365日まで延長できます。より長寿命のトークンが必要な場合は、 Brightcove カスタマーサポート。 しかし、 TTL CDNによってアセットがキャッシュされる最大時間が反映されますが、トークンが期限切れになる前にURLが変更されないことは保証されません。

    メディアへのリンクが切断されないようにする最善の方法は、 Video Cloud 実行時に CMS API または Playback API.

    URLのキャッシュ

    ランタイムAPIリクエストがオプションでない場合は、少なくとも1日に1回リフレッシュされたローカルデータキャッシュからURLを取得することをお勧めします。 TTL いずれか短い方のトークン。

    参照IDの競合

    このセクションは CMS API のみ。

    参照IDの一意性を保証するために、 CMS API 割り当てられている動画に対する操作後、最大3分間IDをロックします。 このため、失敗した要求をすばやく再試行しようとした場合、または以前に割り当てられていた動画を削除した後すぐに参照IDを再利用しようとした場合は、409エラーが返される可能性があります。 を参照してください エラーメッセージリファレンス 詳細はこちら


    ページの最終更新日:12年2020月XNUMX日