API リクエストに郵便配達を使用する
インストールPostman
取得するPostmanからwww.getpostman.com。Postman ChromeまたはMacアプリとしてインストールできます。デスクトップクライアントを入手することをお勧めしますが、Chromeバージョンはどのプラットフォームでも実行でき、機能と外観は同じです。
クライアント認証情報を取得する
ブライトコーブ API を使用するには、使用するアカウントと API のクライアント認証情報が必要です。の指示に従って、Studioでクライアント資格情報を取得しますAPI認証資格情報の管理。以下の手順では、を使用してPlayer ManagementAPIリクエストを作成しますPostman、したがって、資格情報には少なくとも次の権限が必要です。
プレイヤー:読み書き
追加のアクセス許可をいくつでも追加して、より広い範囲の API リクエストに使用できる認証情報を取得できます。また、必要に応じて、複数のアカウントで機能する資格情報が得られます。
あなたが使用することができますこのオンラインアプリ必要に応じて。その場合、少なくとも指定する必要がありますvideo-cloud/player/all
権限。
Postman を使用する
クライアントの資格情報を取得したら、使用を開始する準備ができていますPostman。以下の手順で、いくつかの作成について説明します。プレーヤー管理APIを使用したリクエストPostman。
セットアップPostmanアクセストークンを取得するには
- を起動しますPostmanアプリ。
- 新しいリクエストを作成します。
新しいリクエストの作成 - 新しいリクエストダイアログで、リクエスト名に「GetPlayers」と入力します。
リクエスト名 - [コレクションの作成]をクリックし、コレクション名として「PlayerManagementAPI」と入力します。
リクエストコレクションの作成 - コレクションを保存します。
- 左側のリストでPlayerManagement APIコレクションを見つけ、それをクリックして新しいリクエストを開きます。
プレーヤー管理 API コレクション - に移動します承認タブで、タイプとしてOAuth 2.0を選択し、[リクエストヘッダーに認証データを追加する]が選択されていることを確認します。
認証セクション - クリック新しいアクセストークンを取得する:
新しいアクセストークンの取得 - ダイアログで、次の情報を入力します。
- トークン名:プレーヤー管理API
- 付与タイプ:クライアント認証
- アクセストークンのURL:
https://oauth.brightcove.com/v4/access_token
- クライアントID:(クライアントIDを入力してください)
- クライアントシークレット:(クライアントシークレットを入力してください)
- 範囲:(空白のまま)
- クライアント認証:クライアントの資格情報を本文で送信する
アクセストークンの取得ダイアログ - クリックトークンのリクエスト
- 新しいアクセストークンが表示されるはずです。
新しいアクセストークン
GET
リクエストを送信
これで、APIリクエストを行う準備が整いました。
GET
リクエストする
- 次に、次のURLをに入力しますリクエストURLを入力してくださいフィールド、{account_id}をアカウントIDに置き換えます。
https://players.api.brightcove.com/v2/accounts/YOUR_ACCOUNT_ID/players
リクエストURLを入力してください - メソッドをそのままにします
GET
、をクリックします送信:GET
リクエスト - レスポンスは次のようになります。
応答を取得
POST
リクエストを送信
今、私たちは送信しますPOST
いくつかのデータを要求します。この場合、Player ManagementAPIを使用して新しいプレーヤーを作成します。
POST
リクエストする
- GetPlayersリクエストを複製します。
リクエストの複製 - 新しいリクエストを開き、名前を「CreatePlayer」に変更します
名前の変更要求 - の場合と同じURLを使用します
GET
上記の手順をリクエストしますが、ここで選択しますPOST
選択されたHTTPメソッドになります。POST
リクエスト - クリック体 URLのすぐ下にあるタブをクリックし、生ラジオボタンとJSON(アプリケーション/ json)タイプドロップダウンメニューから:
リクエスト本文 - 新しいヘッダーがリクエストに自動的に追加されることに気付くかもしれません。データを送信するリクエストには、送信されているデータの種類をAPIに通知するヘッダーが必要です。クリックヘッダータブを表示して
Content-Type: application/json
ヘッダ:ヘッダーを追加 - 生データの場合は、本文に次の JSON コードを入力します (JSON に続くスクリーンショットは、リクエストの表示方法を示しています)。
{ "name": "Postman Test Player" }
- [ 送信 ] をクリックします。
-
レスポンスは次のようになります(よりきれいにフォーマットされたJSONの場合は、プリティボタンをクリックします)。
POSTレスポンス - Studioの[プレーヤー]セクションをチェックして、プレーヤーが作成されたことを確認できます。
環境変数
複数のアカウントおよびAPI操作の任意の組み合わせに対してクライアント資格情報を作成できますが、資格情報の範囲を単一のアカウントとAPI(または特定のAPI操作)に制限することで、セキュリティを強化したい場合があります。もしそうなら、あなたは利用することができますPostmanの環境変数複数のアカウントとAPIにわたるリクエストのテストを簡素化するため。重要なのは、使用するクライアント資格情報の各セットに対応する環境をセットアップすることです。
以下は、の環境変数を作成および使用するための手順です。client_id
そしてclient_secret
。
- 右上の歯車メニューをクリックしますPostman選択します環境を管理します。
環境メニュー - の中に環境の管理ダイアログをクリックし、追加環境を追加します。
- 新しい環境の場合は、次のように入力します。
- 名前(Brightcove APIS、または好きなもの)
- と呼ばれる環境変数
account_id
アカウントIDの値を使用 - と呼ばれる環境変数
client_id
クライアントIDの値を使用 - と呼ばれる環境変数
client_secret
あなたのクライアントシークレットの値で
環境変数の追加 - クリック追加環境を追加するには
- 閉じます環境の管理戻るダイアログPostmanメニューから環境を選択します。
環境を選択する - これで、リクエスト内のハードコードされた値を変数に置き換えることができます。これを行うには、入力するだけです
{{
どこにでも、変数のドロップダウンリストが表示されます:環境変数の使用
APIリファレンスからコレクションを作成する
バージョン6.7.4以降、Postmanリクエストコレクションを作成するためのOpenAPI仕様のインポートをサポートします。BrightcoveのプラットフォームAPIリファレンスはOpenAPI仕様に基づいているため、この機能を使用して、任意のBrightcoveAPIのリクエストの完全なコレクションを生成できます。
以下の手順では、Dynamic Ingest API例として、この手順はどのBrightcoveプラットフォームAPIでも機能します(ない PostmanはRESTAPIのみをサポートしているため、PlayerAPIまたはモバイルSDKの場合)。
ステップ
- ブラウザで、動的取り込みAPIリファレンス
- クリックしてくださいDownloadタイトルの下にあるボタンをクリックしてダウンロードしますOpenAPI specification APIの場合:
OpenAPI 仕様をダウンロードする - 使用しているブラウザによっては、仕様(YAMLファイル)がダウンロードされるか、新しいブラウザタブで開く場合があります。ブラウザで開いた場合は、コンテンツをコピーしてテキストファイルに貼り付けるか、ページソースをローカルドライブに保存します。ファイルには名前を付ける必要があります
openapi.yaml
。 - 今すぐに行きますPostmanをクリックしますImport左側のウィンドウ上部にあるボタン:
郵便配達員のインポートボタン - ドラッグアンドドロップ
openapi.yaml
ファイルマネージャから開いたインポートモーダルへのファイル:郵便配達のインポートモーダル - 後Postmanファイルを処理すると、リストに新しいコレクションが表示されます。Dynamic Ingest API Reference
新しい郵便配達コレクション - を介してフォルダにドリルダウン
accounts/{account id}/video/{video id}
リクエストが表示されます:リクエストへのドリルダウン - を選択
POST
それを開くように要求します。あなたは両方を見つけるでしょうParamsそしてそのBody APIリファレンスから事前に入力されていますが、データ型を示すプレースホルダーを実際のデータに置き換える必要があります。事前設定されたパラメータ 事前移入されたボディ - プレースホルダーを適切な値に置き換えたら、自分で作成したものと同じようにリクエストを使用できます。