サポート サポート問い合わせ先 | システムステータス システムステータス

クイックスタート: OAuth API

このチュートリアルでは、クライアント資格情報とアクセストークンを取得する手順について説明します。 OAuth API.

要件

  • このチュートリアルのAPI呼び出しは、MacOSとすべてのlinux / unixシステムに組み込まれているcURLを使用しています。 Windowsを実行している場合は、 cURLを設定する
  • あなたのシステムにはTerminalやその他のコマンドラインコンソールが必要です

概要

Brightcoveの使用には2つの部分があります OAuth API 他のBrightcove APIにアクセスする

  • クライアントの資格情報を取得する(a client_idclient_secret)は必要なアカウントとAPI操作に有効です。これは一度の操作です。将来の使用のために、client_idとclient_secretを安全な場所に保存することを条件とします
  • ゲット access_token access_tokenは5分に有効です。ほとんどの場合、あなたはあなたが作るAPI呼び出しごとに1つを取得します

また、スタジオにも使用できるUIがあります クライアント資格情報の取得と管理。 可能であれば、UIを使用することをお勧めします。 新しいAPIの場合、しばらくUIを介して資格情報を利用できない場合があります。 OAuth API、次の手順で行う方法を学習します。

クライアントの資格情報を取得する

これらの手順では、cURLコマンドを使用して、 Player Management API.

ステップ

  1. 説明されているようにcURLを使用できることを確認してください 要件; コマンドラインに移動して入力してテストすることができます curl returnキーを押す - cURLがインストールされている場合は、次のようなメッセージが表示されます。
            curl: try 'curl --help' or 'curl --manual' for more information
  2. これで、Studioから入手できる2つの情報が必要になります。 に移動してStudioにログインする Studio.
    • アカウントID
    • BC_TOKEN

    注: BC_TOKEN 値はStudioを開いたときに設定されたCookieです。 Studioで扱うAPI管理トークンとは関係ありません。

アカウントIDとBC_TOKENを取得する

  1. まず、アカウント情報からアカウントIDが必要です。
  2. 設定アイコンをクリックします。 アカウント設定 スタジオのヘッダーに表示されます。
  3. ドロップダウンから[アカウント情報]を選択します。
  4. アカウント情報ページからアカウントIDをコピーして保存します。後の手順で必要になります。
  5. ほとんどのブラウザで、OPTION-CMD-i(Mac)またはALT-CTRL-i(Windows)を押すことでこれを行うことができます。そうしないと、メニュー項目も見つかるはずです。
  6. コンソールで、次のJavaScriptを貼り付けてリターンキーを押すと、BC_TOKENがモーダルダイアログに表示されます。
  7. BC_TOKENをクリップボードにコピーします。
  8. アカウントIDとBC_TOKENをここに入力してください:

    アカウントID:

    BC_TOKEN:

資格情報を要求する

  1. クライアントの資格情報を取得するには、コマンドラインで次のcURLコマンドをコピー&ペーストして、Returnキーを押します。
  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}

    これは Studio上ではサポートされていません。 有効なクライアントの秘密 - あなたは 決して クライアントの秘密を公開します。

  3. の値を入力してください client_idclient_secret あなたがこれらを必要とするので、いつでもあなたは access_token.
    クライアントの資格情報

    クライアントID:

    client_secret:

トークンにアクセスする

挽き目 client_idclient_secret あなたは前のステップで得られたものを ユーザー名パスワード あなたが access_token。 ここで使用するcURLでは、これらを渡すことができます --user パラメータ。 他の言語では、HTTP要求でBasic Authorizationヘッダーにこれらを渡します。

        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日