Selling Partner API
Что такое Selling Partner API Amazon, кто на нём строит приложения, как продавец авторизует приложение, а также регионы и лимиты.
Как публикует Amazon
Предметная область в том виде, в каком её публикует Amazon. Эта страница не описывает какое-либо конкретное приложение; каждое утверждение пересказывает публичную документацию из раздела Источники.
Что это
Selling Partner API (SP-API) — REST API Amazon для селлинг-партнёров (продавцов и вендоров) и для разработчиков, которые работают от их имени.
- Он отдаёт собственные данные селлинг-партнёра: заказы, запасы, каталог, цены, финансовые события, отчёты и уведомления.
- Это другой API, чем Amazon Ads API, со своей регистрацией, ролями и авторизацией.
Разработчики и роли
- Типы разработчиков. Private developer делает приложение только для собственной организации. Public developer делает приложение, которое авторизуют другие селлинг-партнёры; он регистрируется через Solution Provider Portal и обязан разместить приложение в Selling Partner Appstore.
- Роли. Каждое приложение запрашивает роли, и каждая роль открывает набор операций — например Inventory and Order Tracking, Finance and Accounting, Brand Analytics, Pricing, Product Listing и Selling Partner Insights. Приложение может вызывать только операции выданных ему ролей.
- Ограниченные роли. Роли, открывающие персональные данные (PII), например доставка напрямую покупателю или выставление налоговых счетов, ограничены: они требуют дополнительной проверки, а каждый вызов, возвращающий PII, требует короткоживущего Restricted Data Token (RDT), который выдаёт Tokens API.
- Политики. Каждый разработчик принимает Acceptable Use Policy (AUP) и Data Protection Policy (DPP). Они ограничивают, для чего можно использовать данные Amazon и как их хранить, защищать, удерживать и удалять.
Авторизация
- Селлинг-партнёр авторизует приложение через Login with Amazon (LWA) — из Selling Partner Appstore или с сайта самого приложения, — и приложение получает refresh token для этого селлинг-партнёра.
- Refresh token обменивается на access token, который истекает через час и передаётся в каждом вызове в заголовке
x-amz-access-token.
Без подписи запросов
С октября 2023 года вызовам больше не нужны подпись AWS Signature Version 4 и роль AWS IAM; достаточно LWA access token.
Регионы и лимиты
| Регион | Хост |
|---|---|
| Северная Америка | sellingpartnerapi-na.amazon.com |
| Европа | sellingpartnerapi-eu.amazon.com |
| Дальний Восток | sellingpartnerapi-fe.amazon.com |
- Планы использования. У каждой операции есть rate и burst, которые применяются как token bucket на пару селлинг-партнёр + приложение.
- Превышение лимита. Превышение лимита отвечает HTTP 429.
- Песочница. У каждого регионального хоста есть песочница, которая отдаёт статические или динамические тестовые ответы, чтобы разрабатывать, не трогая живые данные.
- Асинхронные данные. Большие наборы данных приходят через Reports API (запрос, опрос, скачивание), а изменения можно получать push-уведомлениями через Notifications API в очередь Amazon SQS или в Amazon EventBridge.
В этом разделе
- Selling partner — кто авторизует приложение, что возвращает авторизация, маркетплейсы по регионам
- Типы разработчиков и роли — приватные и публичные приложения, все роли, ограниченные роли и Restricted Data Token
- Защита данных и хранение — Acceptable Use Policy и Data Protection Policy по разделам
- Проверка личности (KYC) — кто проходит проверку, какие документы, сколько она длится
- Песочница — статическая и динамическая песочницы, эндпоинты, лимиты