支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    快速開始: 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日