Amazon Selling Partner API (SP-API)

Обзор

Amazon SP-API — это REST API для продавцов и вендоров Amazon, позволяющий управлять товарами, заказами, ценами, отчётами, логистикой и финансами программно.

SP-API пришёл на смену Amazon MWS (Marketplace Web Service) и предоставляет более гранулярный доступ к данным продавца.

Аутентификация

Login with Amazon (LWA) OAuth 2.0

Процесс авторизации:

1. Зарегистрировать приложение в Seller Central
2. Получить refresh_token через авторизацию продавца (grant flow)
3. Обменивать refresh_token на access_token (TTL 1 час)

Токен передаётся в заголовке:

x-amz-access-token: <LWA_access_token>

Обновление токена:

POST https://api.amazon.com/auth/o2/token
grant_type=refresh_token
refresh_token=<refresh_token>
client_id=<client_id>
client_secret=<client_secret>

Base URL

https://sellingpartnerapi-na.amazon.com      # Северная Америка
https://sellingpartnerapi-eu.amazon.com      # Европа
https://sellingpartnerapi-fe.amazon.com      # Дальний Восток

Rate Limits

• Алгоритм: Leaky bucket (token bucket) для каждой группы эндпоинтов
• Заголовки ответа: x-amzn-RateLimit-Limit (только для успешных запросов)
• При превышении: HTTP 429 с заголовком Retry-After
• Лимиты зависят от эндпоинта (от 0.016 до 30 запросов в секунду)

Модели работы

• FBA (Fulfillment by Amazon) — хранение и доставка силами Amazon
• FBM (Fulfillment by Merchant) — хранение и доставка продавцом
• Seller Central — основная панель управления продавца

Разделы API

Раздел	Содержание
Общее	Sellers, Tokens
Каталог	Catalog Items, Listings Items, Product Types
Ценообразование	Product Pricing, Product Fees
Заказы	Управление заказами
Отчёты и фиды	Reports, Feeds (массовые операции)
Финансы	Транзакции, переводы
FBA Inbound	Поставки на склады Amazon
FBA Outbound	Отгрузки со складов, инвентарь
Уведомления	Вебхуки и подписки на события
Доставка	Merchant Fulfillment, Shipping
Сообщения	Общение с покупателями
Аналитика	Sales analytics