Selling Partner APIモデルでのPostmanの使用
Selling Partner APIモデルでのPostmanの使用
このドキュメントでは、Selling Partner API(SP-API)モデル用に{{0}}をセットアップして使用する方法について説明します。{{1}}を使用して、Amazonアカウントでログイン(LWA)アクセストークンを生成し、SP-APIモデルをインポートして、SP-APIエンドポイントへの呼び出しを行い、SP-APIサンドボックスエンドポイントへの呼び出しを行うことができます。
呼び出しを行うために必要な認証情報
- LWA
client_id
およびclient_secret
。これらの認証情報は、アプリケーションを登録した後に取得します。詳細については、アプリケーション情報と認証情報の表示を参照してください。 - LWA リフレッシュトークン。LWA 更新トークンは後に取得されます。 アプリケーションを承認する。
- SP-APIエンドポイント。詳細については、SP-APIのエンドポイントを参照してください。
Postman を使用してログイン・ウィズ・アマゾン (LWA) アクセストークンを生成する
Amazonアカウントでログイン(LWA)を使用すると、Amazon購入者は、Amazonのユーザー名とパスワードを使用して、登録済みのサードパーティウェブサイトまたはモバイルアプリ(「クライアント」)にログインできます。クライアントは、名前、メールアドレス、郵便番号など、Amazonプロフィールにある個人情報を共有するよう購入者に求めることがあります。SP-APIモデルで{{0}}を使用するには、その前にまずSP-APIに認証するためのアクセストークンを生成する必要があります。
-
[開く] 郵便配達員 そして、アカウントにログインします。
-
にとって Workspaces、ワークスペースを選択してください。
-
Newを選択します。
-
で Create New ダイアログボックス、選択 HTTP Request。
-
にとって Request、選択してください POST。
-
次のリンクをコピーしてテキストボックスに貼り付けます。
https://api.amazon.com/auth/o2/token -
選択してください Authorization タブとフォー Type、選択してください No Auth。
-
選択してください Body タブをクリックして選択 x-www-form-urlencoded。
-
の中に Body 表、以下のキーと値のペアを追加してください。
キー Value grant_type
refresh_token refresh_token
[リフレッシュトークンの値] client_id
[クライアントIDの値] client_secret
[クライアントシークレットの値] -
Sendを選択します。
レスポンスにより、SP-APIへの認証に使用するアクセストークンが返されます。
"access_token": "Atza|*****",
"refresh_token": "Atzr|*****"'
"token_type": "bearer",
"expires_in": 3600
SP-APIモデルをPostmanにインポートする
SP-APIエンドポイントを呼び出す前に、SP-APIモデルを{{0}}にインポートする必要があります。
-
GitHub上のselling-partner-api-modelsフォルダを開きます。
-
フォルダのリストで、ダウンロードするAPIモデルを見つけて選択し、JSONファイルを選択します。
-
JSON ファイルビューで、 Raw ソースコードを表示するか、ダウンロードアイコンを選択して RAW ファイルをダウンロードします。
-
モデルのソースコードをコピーします。
-
テキストエディター(メモ帳など)を開き、モデルテキストを貼り付けます。次に、ファイルに「.json」拡張子を付けて保存します。
-
郵便配達員にサインインします。
-
にとって Workspaces、ワークスペースを選択してください。
-
選択 Import、JSON ファイルを選択して選択してください Open。
-
で Import ダイアログボックス、選択 Postman Collection そして選んで Import。
ファイルが正常にインポートされると、成功メッセージが表示されます。
SP-APIエンドポイントを呼び出す
-
郵便配達員にサインインします。
-
にとって Workspaces、ワークスペースを選択してください。
-
で Collections タブをクリックし、新しくインポートした API を選択し、
GET
オペレーション。 -
まだお持ちでない場合は、Postmanを使用してLWAアクセストークンを生成します。リフレッシュトークンを生成するLWAアクセストークンが必要になります。
-
で Headers タブをクリックし、次のキーペアを追加します。
キー Value x-amz-access-token
[アクセストークン値] -
Sendを選択します。
応答テキストは次の場所に入力されます。 Response ウィンドウ。
SP-APIサンドボックスエンドポイントを呼び出す
Selling Partner APIサンドボックスへの呼び出しを行うプロセスは、 Selling Partner APIサンドボックスエンドポイントへの呼び出しを指示する以外は実稼働呼び出しを行う場合と同じです。Selling Partner APIでは、実稼働データに影響を与えたり、実際のイベントを発生させたりすることなく、アプリケーションをテストできる2つのサンドボックス環境が提供されます。
Selling Partner APIの静的サンドボックスは、パターンマッチングを使用して静的な模擬レスポンスを返します。Selling Partner APIの動的サンドボックスは、リクエストパラメーターに基づいて現実的なレスポンスを返すことができるサンドボックスバックエンドにリクエストをルーティングします。
詳細については、Selling Partner APIサンドボックスを参照してください。
-
郵便配達員にサインインします。
-
使用しているAPIのSwaggerモデルをhttps://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/ordersV0.jsonワークスペースにインポートします。たとえば、注文API Swaggerモデルです。
-
にとって Workspaces、ワークスペースを選択してください。
-
で Collections タブをクリックし、コレクションを選択して
GET
オペレーション。たとえば、GET Orders API 呼び出しをテストする場合は、以下を選択します。 get Orders API コール。 -
{{baseUrl}}
をSelling Partner APIサンドボックスとして設定します。 -
Paramsタブで、Swaggerモデルからの静的リクエスト値を渡します。たとえば、注文APIです。
-
サンドボックスエンドポイントを呼び出すときは、対応するSwaggerモデルで定義されている必須パラメーターがすべてリクエストに含まれていることを確認する必要があります。注文API v0 Swaggerモデルの次の例を参照してください。ここでは、成功したレスポンスで注文の取得API呼び出しが強調表示されています。
-
まだお持ちでない場合は、Postmanを使用してLWAアクセストークンを生成します。リフレッシュトークンの生成にLWAアクセストークンが必要になります。
-
で Headers タブをクリックし、次のキーペアを追加します。
キー Value x-amz-access-token
[アクセストークン値] -
Sendを選択します。
-
レスポンスで、Swaggerモデルと一致するペイロードが返されることを確認します。
応答テキストは次の場所に入力されます。 Response ウィンドウ。
Updated 23 days ago