快速開始： Dynamic Ingest API

簡介

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

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

步驟

獲取客戶憑證

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

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

2. 點擊 註冊新申請

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

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

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

獲取OAuth令牌

client_id 和 client_secret 用作用戶名和密碼以獲取令牌（基本身份驗證），該令牌用於身份驗證後續請求。

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 用你自己的 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_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://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以外的其他測試工具：

• 失眠
• 郵差