快速入門：動態攝取 API

簡介

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

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

步驟

獲取客戶憑證

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

1. 給管理 API 憑據工作室的一部分。

2. 點擊註冊新應用

3. 選擇適當的帳戶並選擇至少這些權限：

   • 動態提取創建
   • 攝取配置文件配置讀取
   • 攝入資料閱讀

4. 複製並保存客戶編號和客戶機密創建的（關閉對話框後無法再次獲取客戶端密碼！）。

獲取OAuth令牌

這client_id和client_secret作為用戶名和密碼得到一個token（基本認證），用於後續請求的認證。

1. 將下面的代碼複製到文本編輯器中，並替換CLIENT_ID和CLIENT_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 中創建視頻對象。請求的正文規定了元數據，例如name和description .唯一必填字段是name .

1. 將以下代碼複製到文本編輯器中並替換ACCOUNT_ID使用您自己的視頻雲帳戶 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在下面的 Ingest 請求中，讓 Video Cloud 知道要將您的視頻源文件與哪個視頻相關聯。

攝取請求

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

1. 將以下代碼複製到文本編輯器中並替換ACCOUNT_ID使用您自己的視頻雲帳戶 ID，VIDEO_ID與id創建視頻時返回的值，以及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://support.brightcove.com/test-assets/videos/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以外的其他測試工具：

• 失眠
• 郵差