---
lang: ja-jp
breaks: true
---
# `Postman` を使用して、`SP-API` のテストコールを行う 2023-05-02

## 参考資料

> Selling Partner API
> https://spapi-apac-doc.s3.ap-northeast-1.amazonaws.com/SP-API%E8%A8%AD%E5%AE%9A%E3%83%9E%E3%83%8B%E3%83%A5%E3%82%A2%E3%83%AB_%E6%97%A5%E6%9C%AC%E8%AA%9E_20230316.pdf
> 
> 

> Using Postman for Selling Partner API models
> https://developer-docs.amazon.com/sp-api/docs/using-postman-for-selling-partner-api-models
> 

> Amazon MWS から SP-API への移行 [Postmanによるテスト接続編]
> https://zats-firm.com/2021/09/08/amazon-mws-%e3%81%8b%e3%82%89-sp-api-%e3%81%b8%e3%81%ae%e7%a7%bb%e8%a1%8c-postman%e3%81%ab%e3%82%88%e3%82%8b%e3%83%86%e3%82%b9%e3%83%88%e6%8e%a5%e7%b6%9a%e7%b7%a8/
> 

> Postman
> https://www.postman.com/
> 

## Login with Amazon（LWA）アクセストークンのリクエスト

> 出品パートナーAPIへの接続
> ステップ1.Login with Amazonアクセストークンをリクエストする
> https://github.com/amzn/selling-partner-api-docs/blob/main/guides/ja-JP/developer-guide/SellingPartnerApiDeveloperGuideForVendors(%E6%97%A5%E6%9C%AC%E8%AA%9E).md#%E3%82%B9%E3%83%86%E3%83%83%E3%83%971login-with-amazon%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%82%92%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%99%E3%82%8B
> 

> アクセストークンとリフレッシュトークンを取得する
> https://developer.amazon.com/ja/docs/login-with-amazon/retrieve-token-other-platforms-cbl-docs.html
> 

> アクセストークンリクエスト
> https://developer.amazon.com/ja/docs/login-with-amazon/authorization-code-grant.html#access-token-request
> 

1. HTTPメソッド
* POST
2. リクエストURL
* 北米）https://api.amazon.com/auth/o2/token
* 日本）https://api.amazon.co.jp/auth/o2/token


3. POSTのリクエストパラメータの設定
* Bodyに設定
* x-www-form-urlencoded


4. リクエストパラメータ
* デベロッパーセントラルに表⽰されるLWA認証情報より、以下のパラメータを設定します。
* 
* grant_type
* refresh_token
* refresh_token
* デベロッパーセントラルで⽣成したリフレッシュトークン
* client_id
* クライアントID（デベロッパーセントラル→LWA認証情報）
* client_secret
* クライアント機密情報（デベロッパーセントラル→LWA認証情報）


5. 「Send」ボタンを押してレスポンスを取得します。


:::warning
access_tokenは1時間のみ有効です。1時間経過した場合は再度[Send]ボタンを押し、再取得してください。
:::

## `Sellers API` の実行

> Sellers API v1 reference
> https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference
> 

:::info
`Sellers API`
出品者に代わって、出品用アカウントに関する情報(参加しているマーケットプレイスなど)を取得します。
:::

> selling-partner-api-models/models/sellers-api-model/sellers.json
> https://github.com/amzn/selling-partner-api-models/blob/main/models/sellers-api-model/sellers.json
> 

> 出品パートナーAPIエンドポイント
> https://github.com/amzn/selling-partner-api-docs/blob/main/guides/ja-JP/developer-guide/SellingPartnerApiDeveloperGuide(%E6%97%A5%E6%9C%AC%E8%AA%9E).md#%E5%87%BA%E5%93%81%E3%83%91%E3%83%BC%E3%83%88%E3%83%8A%E3%83%BCapi%E3%82%A8%E3%83%B3%E3%83%89%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88
> 

> marketplaceId値
> https://github.com/amzn/selling-partner-api-docs/blob/main/guides/ja-JP/developer-guide/SellingPartnerApiDeveloperGuide(%E6%97%A5%E6%9C%AC%E8%AA%9E).md#marketplaceid%E5%80%A4
> 

1. HTTPメソッド
* GET
2. リクエストURL
* 日本）https://sellingpartnerapi-fe.amazon.com/sellers/v1/marketplaceParticipations


3. リクエストパラメータ
* 「Params」タブに設定
* marketplace
* A1VC38T7YXB528
* ※日本のマーケットプレイス


4. リクエストヘッダ
* host
* sellingpartnerapi-fe.amazon.com
* ※エンドポイントのFQDN
* x-amz-access-token
* リフレッシュトークンから取得したアクセストークン
* x-amz-date
* 20230502T134100Z
* YYYYMMDDThhmmssZ
* リクエスト⽇時
* user-agent
* My Selling Tool/2.0 (Language=Java/1.8.0.221; Platform=Windows/10)
* ※アプリケーション名、バージョン番号、プラットフォーム、プログラミング⾔語


5. 「Authorization」タブに以下の情報で署名を作成します。

* Type
* AWS Signature
* 

* AccessKey
* AWS IAMユーザーのAWSアクセスキーID
* 
* SecretKey
* AWS IAMユーザーのシークレットアクセスキー
* 
* AWS Region
* 米国東部 (バージニア北部)＝＞us-east-1
* 米国東部 (オハイオ)＝＞us-east-2
* アジアパシフィック (大阪)＝＞ap-northeast-3
* アジアパシフィック (東京)＝＞ap-northeast-1
* Service Name
* execute-api
* Session Token
* ※指定なし（ブランク）


6. [Send] ボタンでSellers API のレスポンスが返却されます。


###### tags: `Amazon Selling Partner API` `SP-API` `Postman`