簡介
您可以使用 Dynamic Ingest API,但主要功能是將視頻添加到 Video Cloud。 此快速入門提供了一個簡單的教程,以指導您使用API提取第一個視頻。
本教程使用流行的命令行工具CURL發出HTTP請求。 如果您不熟悉CURL,請參閱 設置CURL。 請注意,默認情況下會安裝CURL以及Mac和Linux系統。 在Windows上,您需要安裝它-設置CURL指南中的說明。
步驟
獲取客戶憑證
這是為API請求創建客戶端憑據的一次性步驟。 如果您已經具有必要的客戶端憑據,則可以跳過此步驟。
-
到了 管理API憑證 Studio部分。
- 點擊 註冊新申請
-
選擇適當的帳戶,然後選擇 至少 這些權限:
- 動態提取創建
- 攝取配置文件配置讀取
- 攝入資料閱讀
-
複製並保存 客戶編號 以及 秘密客戶 創建的密碼(關閉對話框後就無法再次獲取客戶端密碼!)。
獲取OAuth令牌
client_id
以及 client_secret
用作用戶名和密碼以獲取令牌(基本身份驗證),該令牌用於身份驗證後續請求。
- 將下面的代碼複製到文本編輯器中,然後替換
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
- 複製修改後的代碼並將其粘貼到終端(或命令行應用程序)中,按Return鍵運行它。
- 響應應如下所示:
{ "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 }
- 請注意
access_token
它會在5分鐘後過期,但是您可以在需要時重新運行該代碼以獲取一個新代碼。 如果以下步驟中的API請求返回了一個UNAUTHORIZED
錯誤。
製作視頻
致電 CMS API 在以下位置創建視頻對象 Video Cloud。 請求的主體規定了元數據,例如 name
以及 description
。 唯一需要的字段是 name
.
- 將以下代碼複製到文本編輯器中並替換
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"}'
- JSON響應將包含視頻的各種元數據,但出於我們的目的,重要字段位於頂部:
{ "id": "123456789001", … }
您將使用此
id
在下面的“提取”請求中 Video Cloud 知道要與您的視頻源文件關聯的視頻。
攝取請求
調用動態攝取可提供要攝取的文件的位置。
- 將以下代碼複製到文本編輯器中並替換
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搜索與您的作業相關的作業。
- 您應該收到如下響應:
{"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
- 您應該保存作業ID,因為它有助於識別與此作業相關的通知,或者在需要與支持人員聯繫時
如果您成功完成了上述步驟,請使用 Dynamic Ingest API。 如果您有任何問題或疑問,請隨時與我們聯繫 Brightcove學習服務 尋求幫助。
如果您將廣泛使用我們的API,則可能有興趣嘗試使用CURL以外的其他測試工具: