Requirements
- このチュートリアルのAPI呼び出しは、MacOSとすべてのlinux / unixシステムに組み込まれているcURLを使用しています。 Windowsを実行している場合は、 cURLを設定する
- あなたのシステムにはTerminalやその他のコマンドラインコンソールが必要です
概要
Brightcoveの使用には2つの部分があります OAuth API 他のBrightcove APIにアクセスする
- クライアントの資格情報を取得する(a
client_id
およびclient_secret
)は必要なアカウントとAPI操作に有効です。これは一度の操作です。将来の使用のために、client_idとclient_secretを安全な場所に保存することを条件とします - ゲット
access_token
access_tokenは5分に有効です。ほとんどの場合、あなたはあなたが作るAPI呼び出しごとに1つを取得します
また、スタジオにも使用できるUIがあります クライアント資格情報の取得と管理。 可能であれば、UIを使用することをお勧めします。 新しいAPIの場合、しばらくUIを介して資格情報を利用できない場合があります。 OAuth API、次の手順で行う方法を学習します。
クライアントの資格情報を取得する
これらの手順では、cURLコマンドを使用して、 Player Management API.
ステップ
- 説明されているようにcURLを使用できることを確認してください Requirements; コマンドラインに移動して入力してテストすることができます
curl
returnキーを押す - cURLがインストールされている場合は、次のようなメッセージが表示されます。curl: try 'curl --help' or 'curl --manual' for more information
- これで、Studioから入手できる2つの情報が必要になります。 に移動してStudioにログインする Studio.
- アカウントID
- BC_TOKEN
注:
BC_TOKEN
値はStudioを開いたときに設定されたCookieです。 Studioで扱うAPI管理トークンとは関係ありません。
アカウントIDとBC_TOKENを取得する
- まず、アカウント情報からアカウントIDが必要です。
- 設定アイコンをクリックします。
スタジオのヘッダーに表示されます。
- ドロップダウンから[アカウント情報]を選択します。
- アカウント情報ページからアカウントIDをコピーして保存します。後の手順で必要になります。
- ほとんどのブラウザで、OPTION-CMD-i(Mac)またはALT-CTRL-i(Windows)を押すことでこれを行うことができます。そうしないと、メニュー項目も見つかるはずです。
- コンソールで、次のJavaScriptを貼り付けてリターンキーを押すと、BC_TOKENがモーダルダイアログに表示されます。
- BC_TOKENをクリップボードにコピーします。
- アカウントIDとBC_TOKENをここに入力してください:
アカウントID:
BC_TOKEN:
資格情報を要求する
- クライアントの資格情報を取得するには、コマンドラインで次のcURLコマンドをコピー&ペーストして、Returnキーを押します。
- 応答は次のようになります(フォーマットが追加されました)。
{"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上ではサポートされていません。 有効なクライアントの秘密 - あなたは 決して クライアントの秘密を公開します。
- の値を入力してください
client_id
およびclient_secret
あなたがこれらを必要とするので、いつでもあなたはaccess_token
.
トークンにアクセスする
client_id
および client_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でエンコードする必要があります。
ステップ
- あなたのaccess_tokenを取得するには、次のcURLコマンドをコピーしてコマンドラインに貼り付け、Enterキーを押します。
- 出力は次のようになります。
{"access_token":"ACkkpftcuhyzqdf4ftxm304za3anhziG0Ni5-S_dplxMNYNrSrBZRgJL3sf_U38ZZVDdgkmWtrb0_GRZj-VzWOAFWgpEYwgwIWLjcGsTI-9QMUMNv2eFj33clsWFHnGLzgtdcILXpR-wPM0LzKKzRahodwofPfuExYCej18Wpt1x7DxOJDySEjCGOWiTuZVKp1QjG0_nqD9T3TpK3Cchv0suVRTGkYrs15qYSKdxh2-e5XbUiKKptNl8ryvMriavPN66fOh17c09Q0525OPqejkU6uERPTw-sTLU_QjJbRV6psxoSVYKRAetsBikH9XRJbZCSt2JP88O","token_type":"Bearer","expires_in":300}
- このトークンを使用すると、 Player Management API 5分(新しいトークンを取得する必要があります)。 トークンは、HTTPリクエストとともにAuthorizationヘッダーに渡されます。
Authorization: Bearer access_token value