---
# System prepended metadata

title: '`Postman` を使用して、`SP-API` のテストコールを行う 2023-05-02'
tags: [SP-API, Amazon Selling Partner API, Postman]

---

---
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
> ![](https://i.imgur.com/mSMbLWV.png)
> ![](https://i.imgur.com/Jmkv21c.png)

> Using Postman for Selling Partner API models
> https://developer-docs.amazon.com/sp-api/docs/using-postman-for-selling-partner-api-models
> ![](https://i.imgur.com/KrfKhfi.png)

> 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/
> ![](https://i.imgur.com/47jWRD9.png)


> Postman
> https://www.postman.com/
> ![](https://i.imgur.com/xEh0Ii3.png)

## 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://i.imgur.com/6P9EFy3.png)


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


> アクセストークンリクエスト
> https://developer.amazon.com/ja/docs/login-with-amazon/authorization-code-grant.html#access-token-request
> ![](https://i.imgur.com/ga29eMO.png)


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

![](https://i.imgur.com/aVhovjC.png)

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

![](https://i.imgur.com/kjgJINe.png)

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

![](https://i.imgur.com/ZpQm8Yq.png)

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

![](https://i.imgur.com/SeRcAZc.png)

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

## `Sellers API` の実行

> Sellers API v1 reference
> https://developer-docs.amazon.com/sp-api/docs/sellers-api-v1-reference
> ![](https://i.imgur.com/cIPHUXo.png)

:::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
> ![](https://i.imgur.com/6oNng5Q.png)

> 出品パートナー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
> ![](https://i.imgur.com/WNiOohT.png)

> 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
> ![](https://i.imgur.com/bytDQy3.png)


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

![](https://i.imgur.com/z5jTa3I.png)

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

![](https://i.imgur.com/YC5IWJ9.png)


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)
        * ※アプリケーション名、バージョン番号、プラットフォーム、プログラミング⾔語

![](https://i.imgur.com/pJJlVuy.png)

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

    * Type
        * AWS Signature
        * ![](https://i.imgur.com/2dsu26C.png)

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

![](https://i.imgur.com/cnIUE8t.png)


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

![](https://i.imgur.com/uf1FmF8.png)


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