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

    快速開始: OAuth API

    本教程將指導您完成使用以下步驟獲取客戶端憑據和訪問令牌的步驟: OAuth API.

    要求

    • 本教程中的API調用使用cURL,它是在MacOS和所有linux / unix系統上內置的。 如果您正在運行Windows,請參見 設置cURL
    • 您將需要係統的終端或其他命令行控制台

    概述

    使用Brightcove有2個部分 OAuth API 獲得對其他Brightcove API的訪問權限

    • 獲取客戶憑證(一個 client_idclient_secret)對您需要的帳戶和API操作有效-這是一次性操作,只要您將client_id和client_secret保存在某個安全的地方以備將來使用
    • 申請 access_token 提供進行API調用的授權-access_token有效期為5分鐘,因此在大多數情況下,您進行的每個API調用都會獲得一個

    Studio中還有一個UI,可用於 獲取和管理客戶憑證。 建議您盡可能使用UI。 對於新的API,憑據可能在一段時間內無法通過用戶界面使用,在這種情況下,您可以直接從 OAuth API,因為您將在接下來的步驟中學習如何做。

    獲取客戶憑證

    在這些步驟中,我們將使用cURL命令來獲取客戶端的憑據 Player Management API.

    步驟

    1. 確保您有可用的cURL,如 要求; 您可以通過轉到命令行並鍵入來進行測試 curl 然後按回車鍵-如果已安裝cURL,您應該會看到類似以下的消息:
              curl: try 'curl --help' or 'curl --manual' for more information
    2. 現在,您需要從Studio獲得的兩條信息。 通過轉到登錄Studio 工作室.
      • 帳戶ID
      • BC_TOKEN

      注: BC_TOKEN value是打開Studio時設置的Cookie。 它與您在Studio中處理的API管理令牌無關。

    獲取您的帳戶ID和BC_TOKEN

    1. 首先,您需要從“帳戶信息”中獲取您的帳戶ID。
    2. 點擊設置圖標 帳戶設置 在Studio標頭中。
    3. 從下拉列表中選擇帳戶信息。
    4. 從“帳戶信息”頁面複製您的帳戶ID並保存-在以後的步驟中將需要它。
    5. 現在打開瀏覽器開發者控制台-在大多數瀏覽器中,您可以通過按OPTION-CMD-i(Mac)或ALT-CTRL-i(Windows)來執行此操作,或者您也應該能夠找到菜單項。
    6. 在控制台中,粘貼以下JavaScript,然後按return以在模式對話框中顯示您的BC_TOKEN:
    7. 將BC_TOKEN複製到剪貼板。
    8. 在此處輸入您的帳戶ID和BC_TOKEN:

      帳戶ID:

      BC_TOKEN:

    提出憑據請求

    1. 要獲取客戶端憑據,請在命令行中復制並粘貼以下cURL命令,然後按回車鍵:
    2. 響應應如下所示(已添加格式):
              {"redirect_url":null,"maximum_scope":[{"identity":
              {"type":"video-cloud-account","account-id":57838016001},
              "operations":["video-cloud/player/all"]}],"name_html":"Sample-Client",
              "issued_to":"rcrooks@brightcove.com","trusted":null,"expires_at":null,
              "issued_at":"2015-06-18T20:17:12Z","name":"Sample-Client",
              "description_html":null,"revoked":null,"type":"credential",
              "client_secret":"PiQ5s3-tk46DvNBPauknctP3aTIS07zNIa7Kxz3b7hnRMA5JvQdkwa7JpyuX7dnD4RXziA4KEK0n1pEO94Q7,
              "description":null,"client_id":"b63e5ac2-5264-4a5a-971a-a133bc7bd605",
              "issued_user":53255203001}

      這是 有效的客戶機密-您應該 決不 公開暴露客戶機密。

    3. 輸入值 client_idclient_secret 下方,因為您隨時都需要這些, access_token.
      客戶憑證

      client_id:

      client_secret:

    獲取訪問令牌

    client_idclient_secret 您在之前的步驟中獲得的結果將用作 用戶名密碼 請求時進行身份驗證的組合 access_token。 在我們將在此處使用的cURL中,您可以將它們作為 --user 參數。 在其他語言中,您將在HTTP請求的“基本授權”標頭中傳遞這些名稱:

            Authorization: Basic {client_id:client_secret}

    注意:整個client_id:client_secret 必須的, 被Base64編碼以被 OAuth API。 cURL將自動對--user憑據進行Base64編碼,但是使用其他語言時,您需要自己對Base64進行編碼。

    步驟

    1. 要獲取access_token,請將以下cURL命令複製並粘貼到命令行中,然後按Enter:
    2. 輸出應該如下所示:
              {"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}
    3. 此令牌可用於驗證對 Player Management API 5分鐘(然後您需要獲取新令牌)。 令牌通過HTTP請求在Authorization標頭中傳遞:
              Authorization: Bearer access_token value

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