Selling partner
Кто такой selling partner, как он авторизует приложение SP-API и какие маркетплейсы относятся к какому региону.
Как публикует Amazon
Каждое утверждение на этой странице пересказывает публичную документацию Amazon из раздела Источники.
Кто такой selling partner
Selling partner — это продавец (seller) или вендор (vendor), который продаёт через магазины Amazon. Selling partner даёт приложению разрешение вызывать Selling Partner API (SP-API) от своего имени. После этого приложение читает и изменяет только данные этого selling partner и только в пределах выданных ему ролей.
Авторизация
- Публичные приложения авторизует сам selling partner через OAuth — одним из двух процессов, которые отличаются только точкой входа: из Selling Partner Appstore или с сайта приложения. Оба завершаются браузерными редиректами между Amazon и сайтом приложения.
- Приватные приложения авторизуются самостоятельно: организация разработчика авторизует своё приложение в Seller Central, Vendor Central или Solution Provider Portal, реализовывать процесс авторизации не нужно.
Параметры редиректа
В конце процесса через сайт Amazon перенаправляет пользователя в приложение с тремя параметрами:
state— значение, которое приложение сгенерировало и вставило в URI авторизации.selling_partner_id— идентификатор selling partner, который авторизовал приложение.spapi_oauth_code— код авторизации Login with Amazon (LWA), который обменивается на refresh token LWA.
Токены и обновление
- Код авторизации истекает через пять минут.
- Он обменивается на токен в эндпоинте LWA (
https://api.amazon.com/auth/o2/token) сgrant_type=authorization_code; последующие access token получают сgrant_type=refresh_token.
Ежегодная переавторизация
Повторная авторизация обязательна ежегодно, а также всякий раз, когда существующие selling partner должны авторизовать для приложения новые роли. Amazon рекомендует отслеживать возраст токена и раз в год предлагать selling partner авторизоваться заново.
Маркетплейсы по регионам
Каждый selling partner продаёт в одном или нескольких маркетплейсах. У каждого маркетплейса фиксированный id, и он относится к одному региональному эндпоинту SP-API.
Северная Америка
Эндпоинт https://sellingpartnerapi-na.amazon.com, регион AWS us-east-1.
| Маркетплейс | Id |
|---|---|
| Канада | A2EUQ1WTGCTBG2 |
| США | ATVPDKIKX0DER |
| Мексика | A1AM78C64UM0Y8 |
| Бразилия | A2Q3Y263D00KWC |
Европа
Эндпоинт https://sellingpartnerapi-eu.amazon.com, регион AWS eu-west-1.
| Маркетплейс | Id |
|---|---|
| Ирландия | A28R8C7NBKEWEA |
| Испания | A1RKKUPIHCS9HS |
| Великобритания | A1F83G8C2ARO7P |
| Франция | A13V1IB3VIYZZH |
| Бельгия | AMEN7PMS3EDWL |
| Нидерланды | A1805IZSGTT6HS |
| Германия | A1PA6795UKMFR9 |
| Италия | APJ6JRA9NG5V4 |
| Швеция | A2NODRKZP88ZB9 |
| ЮАР | AE08WJ6YKNBMC |
| Польша | A1C3SOZRARQ6R3 |
| Египет | ARBP9OOSHTCHU |
| Турция | A33AVAJ2PDY3EV |
| Саудовская Аравия | A17E79C6D8DWNP |
| ОАЭ | A2VIGQ35RCS4UG |
| Индия | A21TJRUUN4KGV |
Дальний Восток
Эндпоинт https://sellingpartnerapi-fe.amazon.com, регион AWS us-west-2.
| Маркетплейс | Id |
|---|---|
| Сингапур | A19VAU5U5O7RUS |
| Австралия | A39IBJ37TRP1C6 |
| Япония | A1VC38T7YXB528 |