支持 聯繫支持 | 系統狀況 系統狀態

快速開始: Dynamic Ingest API

快速入門將引導您添加視頻到 Video Cloud 使用 Dynamic Ingest API 通過CURL。

簡介

您可以使用 Dynamic Ingest API,但主要功能是將視頻添加到 Video Cloud。 此快速入門提供了一個簡單的教程,以指導您使用API​​提取第一個視頻。

本教程使用流行的命令行工具CURL發出HTTP請求。 如果您不熟悉CURL,請參閱 設置CURL。 請注意,默認情況下會安裝CURL以及Mac和Linux系統。 在Windows上,您需要安裝它-設置CURL指南中的說明。

步驟

獲取客戶憑證

這是為API請求創建客戶端憑據的一次性步驟。 如果您已經具有必要的客戶端憑據,則可以跳過此步驟。

  1. 到了 管理API憑證 Studio部分。

  2. 點擊 註冊新申請
  3. 選擇適當的帳戶,然後選擇 至少 這些權限:

    • 動態提取創建
    • 攝取配置文件配置讀取
    • 攝入資料閱讀
  4. 複製並保存 客戶編號秘密客戶 創建的密碼(關閉對話框後就無法再次獲取客戶端密碼!)。

獲取OAuth令牌

client_idclient_secret 用作用戶名和密碼以獲取令牌(基本身份驗證),該令牌用於身份驗證後續請求。

  1. 將下面的代碼複製到文本編輯器中,然後替換 CLIENT_IDCLIENT_SECRET 使用您自己的客戶憑證:
        curl --request POST \
        --url https://oauth.brightcove.com/v4/access_token \
        --user CLIENT_ID:CLIENT_SECRET \
        --header 'content-type: application/x-www-form-urlencoded' \
        --data grant_type=client_credentials

    您的代碼現在將如下所示:

        curl --request POST \
        --url https://oauth.brightcove.com/v4/access_token \
        --user 0072bebf-0616-442c-84de-7215bb176061:7M0vMete8vP_Dmb9o4a16iws4RQR74PO-JNDKkCOyXFkSIe_iRKdHiiNO6vuBWadn5xFw \
        --header 'content-type: application/x-www-form-urlencoded' \
        --data grant_type=client_credentials
  2. 複製修改後的代碼並將其粘貼到終端(或命令行應用程序)中,按Return鍵運行它。
  3. 響應應如下所示:
        {
          "access_token":"AMv4uy9puUMrSPtfOUo412Euy8gY1pcjv6RozlH9ALrHyekxY_u-83KWMECgigG9u_gSQoh_gpe8ChAQ1FHclNHgU4h_2qj-8ei19Ve-m4OJ2UOmJwJBZQht_6bIMJMZUZBIvIAGT-8av-uMOpqnnXVJ1qu2rPQeGraIjEkhTnXnGaa-RNUxisRkIoIktN1o9BFzrbLa1xstvPgVhdg78uVg8uDA8X0K9kfibxBfdIkDBzKJAViZZ3gQa56uit2r79GZ_t2KSUgLq1rOPsd0TflHwCAGtSaAHlvb44m-hUKFAOJa-FtXakQ72QcIXha5PhSjYTJZiUa4EbjxXpR6aLvPW4mGQcDzo8bQQ4Hnq8bsa_8l5eUjOm51WI96WhTPJCt4bBWVJKyLM8P7va_Ho6zJc2yOJHDamilRlyOS-DxN4U30m_2AxhHF3DKJO8fWl5srtpbZRPANOq5B6cpAkOiQafoXUv0ntP9nzRwyO-oXVvH4iLDTAArOTXPh-A7OD8QogWu9wb13vO48CvRPsGv9PfT4ZCxzUa3M2NXn8wontkSARzHVNqf6fh-iF6ifalPTw-Z9MhpPd-qwpcHbJfmu5EcJAR3K3QDYttjeRrmEvTBOgbQttapvI2h6rMQqgytiHXpxYgz3Hr1yKe1cuVI8z3haT5pb-FIfOfHKyr7vQ3RDXjdTTJZMYpOhKNjL0oEH2ev_bIGmbGnqUMcuAGhQgMiCVQUKwoLUGHTRG91ZWMCP7CfTEdcVc10jDSELcZ1SBig5_G42ymv1w3KauK6ZwE_Xmu4NrPZiPo-r3u_K08x8Rz8gS1b9mFtcPj6yux058WAW--HIoIQRFGeppiO3S6s1hzkU2jiKMGtTnB8X4MIJXLPq8LHcZO81appEzraHFUG5ewtKRTq5Ck6OFndlSmhT8KIKid806wI5b39eeoe-4c8Os23QuyWIQthG-YdcTSueNoqZ3-5e7HztoYbzNIKvtrdLpwgMAclD9fzs3oCclECAQaaLD3hWENE3n78_TzPt4OvQ4o8L17JTmozZYCq3VDnsp_M9Bb6az8mZfDX5_ALunsE65dv91aXFCjTJigVJ_r28k7kLVct-PVZ1XPSjdAyGoxttMeYpl24737aUZBqPAirHJK-griQlPBh04E0Ay5ip03gJvJxvGuzRE5r8hKD0lVQjfre9huiSjJX-xts4kbY",
          "token_type":"Bearer",
          "expires_in":300
        }
  4. 請注意 access_token 它會在5分鐘後過期,但是您可以在需要時重新運行該代碼以獲取一個新代碼。 如果以下步驟中的API請求返回了一個 UNAUTHORIZED 錯誤。

製作視頻

致電 CMS API 在以下位置創建視頻對象 Video Cloud。 請求的主體規定了元數據,例如 namedescription。 唯一需要的字段是 name.

  1. 將以下代碼複製到文本編輯器中並替換 ACCOUNT_ID 用你自己的 Video Cloud 帳戶ID,以及 ACCESS_TOKEN 在前面的步驟中,使用從響應到請求的令牌。
        curl --request POST \
        --url https://cms.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/ \
        --header 'authorization: Bearer ACCESS_TOKEN' \
        --header 'content-type: application/json' \
        --data '{"name": "My Video"}'
  2. JSON響應將包含視頻的各種元數據,但出於我們的目的,重要字段位於頂部:
        {
          "id": "123456789001",
          …
        }

    您將使用此 id 在下面的“提取”請求中 Video Cloud 知道要與您的視頻源文件關聯的視頻。

攝取請求

調用動態攝取可提供要攝取的文件的位置。

  1. 將以下代碼複製到文本編輯器中並替換 ACCOUNT_ID 用你自己的 Video Cloud 帳戶ID, VIDEO_IDid 創建視頻時返回的值,以及 ACCESS_TOKEN 在前面的步驟中,使用從響應到請求的令牌。
        curl --request POST \
          --url https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/VIDEO_ID/ingest-requests \
          --header 'authorization: Bearer ACCESS_TOKEN' \
          --header 'content-type: application/json' \
          --data '{
            "master": {
              "url": "https://learning-services-media.brightcove.com/videos/mp4/Great_Blue_Heron.mp4"
            },
            "callbacks": ["https://solutions.brightcove.com/bcls/di-api/di-callback-app.php"]
          }'

    請注意,此處的視頻和回調應用程序是由Brightcove Learning Services提供的,用於測試目的。 您可以將它們替換為您自己的視頻和/或回調應用程序的路徑。 如果您不需要接收有關提取作業的通知,則可以省略 callbacks 領域。

    如果您確實使用我們的回調應用程序,則可以 查看通知。 該應用程序被其他幾個應用程序用於回調,因此請使用作業ID搜索與您的作業相關的作業。

  2. 您應該收到如下響應:
        {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
  3. 您應該保存作業ID,因為它有助於識別與此作業相關的通知,或者在需要與支持人員聯繫時

如果您成功完成了上述步驟,請使用 Dynamic Ingest API。 如果您有任何問題或疑問,請隨時與我們聯繫 Brightcove學習服務 尋求幫助。

如果您將廣泛使用我們的API,則可能有興趣嘗試使用CURL以外的其他測試工具:


頁面最後更新於12年2020月XNUMX日