要件
- このチュートリアルのAPI呼び出しでは、MacOSおよびすべてのlinux / unixシステムに組み込まれているcURLを使用します。Windowsを実行している場合は、を参照してください。 cURLを設定する
- システムにはターミナルまたはその他のコマンドラインコンソールが必要です
概要
Brightcove OAuthAPIを使用して他のBrightcoveAPIにアクセスするには、2つの部分があります。
- クライアントの資格情報を取得します（
client_idそしてclient_secret）必要なアカウントとAPI操作に有効です-これは1回限りの操作です。ただし、client_idとclient_secretを将来使用するために安全な場所に保存しておく必要があります。 - 取得する
access_tokenこれは、API呼び出しを行うための承認を提供します-access_tokenは5分間有効であるため、ほとんどの場合、API呼び出しごとに1つ取得します
Studioには、次の目的で使用できるUIもあります。クライアント資格情報を取得して管理する。可能な限りUIを使用することをお勧めします。新しいAPIの場合、しばらくの間UI経由で認証情報を利用できない場合があります。その場合、次の手順で行う方法を学習するため、OAuthAPIから直接認証情報を取得できます。
クライアント認証情報を取得する
これらの手順では、cURLコマンドを使用して、Player ManagementAPIのクライアント資格情報を取得します。
ステップ
- で説明されているように、cURLが利用可能であることを確認してください要件 ;コマンドラインに移動して入力することでテストできます
curlそしてreturnキーを押します-cURLがインストールされている場合、次のようなメッセージが表示されます。curl: try 'curl --help' or 'curl --manual' for more information - ここで、Studioから取得できる2つの情報が必要です。に移動してStudioにログインしますスタジオ。
- アカウント ID
- BC_TOKEN
注:
BC_TOKEN値は、Studioを開いたときに設定されるクッキーです。Studioで扱うAPI管理トークンとは関係ありません。
アカウントIDとBC_TOKENを取得します
- まず、アカウント情報からアカウントIDが必要になります。
- 設定アイコンをクリックします
Studioヘッダー内。 - ドロップダウンから[アカウント情報]を選択します。
- アカウント情報ページからアカウントIDをコピーして保存します。これは、後の手順で必要になります。
- 次に、ブラウザ開発者コンソールを開きます。ほとんどのブラウザでは、OPTION-CMD-i（Mac）またはALT-CTRL-i（Windows）を押すことでこれを行うことができます。または、メニュー項目も見つけることができるはずです。
- コンソールで、次のJavaScriptを貼り付け、Returnキーを押して、モーダルダイアログに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}これはない有効なクライアントシークレット- 決してクライアントシークレットを公開します。
- の値を入力します
client_idそしてclient_secret以下では、これらを取得する必要があるときはいつでも必要になるため、access_token。
アクセストークンを取得する
NS client_idとclient_secret前の手順で取得したものは、 ユーザー名パスワード リクエスト時の認証の組み合わせaccess_token。ここで使用するcURLでは、これらを次のように渡すことができます。--userパラメータ。他の言語では、HTTPリクエストとともに基本認証ヘッダーでこれらを渡します。
Authorization: Basic {client_id:client_secret}
注：client_id：client_secret全体 しなければならない OAuthAPIによって受け入れられるようにBase64でエンコードされていること。 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