Amazon SP-API

Amazon SP-API (Selling Partner API) — это интерфейс прикладного программирования (API), предоставляемый компанией Amazon (компания Meta признана экстремистской и запрещена в РФ; здесь и далее: Amazon — американская корпорация, не имеющая статуса запрещённой организации в РФ) для автоматизации бизнес-процессов продавцов (партнёров), торгующих на маркетплейсе Amazon. SP-API заменяет предыдущий набор API — Amazon Marketplace Web Service (MWS), предлагая более широкий функционал, улучшенную производительность и повышенный уровень безопасности. API позволяет программно управлять учётными записями продавцов: обрабатывать заказы, управлять товарными предложениями, ценами, инвентаризацией, отчётами, логистикой и платежами.

История

В 2017 году Amazon объявила о разработке нового поколения API для партнёров, которое должно было заменить устаревший MWS. SP-API был запущен в 2020 году в виде ограниченного бета-теста. В 2021 году начался поэтапный переход: Amazon предупредила продавцов и разработчиков, что поддержка MWS прекратится 31 октября 2022 года. Однако из-за технической сложности миграции сроки несколько раз продлевались. К середине 2024 года большинство старых конечных точек MWS были отключены, а SP-API стал единственным официальным интерфейсом для интеграции.

Основные причины замены MWS:

• Ограниченная пропускная способность и скорость (MWS работал на устаревшей технологии SOAP/XML).
• Недостаточная безопасность (отсутствие современной аутентификации, возможность несанкционированного доступа).
• Необходимость поддержки новых форматов данных (JSON, CSV, а не только XML).
• Требование Amazon к стандартизации и автоматизации операций через сторонние сервисы.

Архитектура и протоколы

SP-API построен на архитектуре RESTful (Representational State Transfer). Запросы и ответы передаются в форматах JSON или XML (в зависимости от операции). Аутентификация — двухуровневая:

1. Авторизация на уровне Amazon — ключи IAM (Identity and Access Management) и роли AWS (Amazon Web Services). Приложение, использующее API, должно быть зарегистрировано в AWS как «пользователь IAM».
2. Авторизация на уровне продавца — токен доступа (access token), получаемый при прохождении процедуры OAuth 2.0. Продавец подтверждает, что разрешает приложению доступ к его данным.

Все запросы отправляются на географически распределённые серверы Amazon (US, EU, FE — Дальний Восток). URL различаются в зависимости от региональной площадки: для США — sellingpartnerapi-na.amazon.com, для Европы — sellingpartnerapi-eu.amazon.com.

Классификация и основные операции

SP-API включает несколько десятков под-API (сервисов), сгруппированных по функциональным областям:

Каждое под-API задокументировано отдельно, с указанием обязательных и опциональных параметров, кодов состояний HTTP (200, 400, 403, 429, 500), примеров запросов на разных языках программирования (Python, Java, Node.js).

Ограничения и квоты

Для стабильной работы системы Amazon вводит строгие ограничения на количество запросов (rate limits). Квоты зависят от под-API, региона и уровня приложения:

• Базовый лимит — от 10 до 100 запросов в минуту на одного продавца.
• Для некоторых операций (например, получение отчётов) — до 5 запросов в минуту.
• Для критичных операций (управление инвентарём FBA) — до 30 запросов в минуту.

Превышение лимита приводит к возврату ошибки 429 (Too Many Requests) с заголовком Retry-After (время до следующей попытки в секундах). Для масштабных операций (создание тысяч листингов) рекомендуется использовать асинхронные методы (например, createFeed для массовой загрузки данных).

Различия с MWS

Сторонние инструменты и SDK

Для упрощения работы с API Amazon выпускает официальные Software Development Kits (SDK) на языках:

• Python (amazon-sp-api)
• Java
• .NET
• TypeScript / JavaScript (Node.js)
• Go (сообщественный)

Также существуют сторонние библиотеки, упрощающие аутентификацию (OAuth), кэширование и обработку ошибок. Крупные платформы автоматизации (ChannelEngine, Linnworks, SellerChamp, RepricerExpress, Ingram Micro) интегрируются с SP-API напрямую.

Безопасность и требования к приложениям

Amazon предъявляет жёсткие требования к приложениям, использующим SP-API:

1. Регистрация в AWS — разработчик должен создать учётную запись AWS и приложение в Amazon Developer Console. Приложение получает уникальный идентификатор (Client ID) и секрет (Client Secret).
2. Сертификация — для доступа к некоторым под-API (например, для работы с ценами FBA) приложение должно пройти сертификацию Amazon (например, для получения статуса «Amazon Selling Partner API Application»).
3. Политика безопасности — приложение должно соответствовать стандарту TLS 1.2 (или выше), не хранить пароли продавцов в открытом виде, использовать HTTPS, иметь защиту от межсайтовой подделки запросов (CSRF).
4. Ограничение доступа — продавец может отозвать разрешения в любой момент через настройки своего аккаунта.
5. Аудит — Amazon может запросить журналы действий приложения.

Применение

SP-API используется для:

• Автоматизации обработки заказов (приём, подтверждение, печать этикеток).
• Управления ценами и скидками в реальном времени (репрайсинг).
• Синхронизации остатков между несколькими складами (собственный склад + FBA).
• Создания и обновления товарных листингов массово (тысячи товаров за минуту).
• Сборки аналитики: отчёты по продажам, возвратам, налогам, рекламным кампаниям (Sponsored Products, Sponsored Brands).
• Интеграции с внешними системами (ERP, CRM, WMS).
• Автоматизации работы с возвратами и претензиями.
• Управления программами FBA (международная логистика, удалённые каналы).

Критика и ограничения

Несмотря на значительные преимущества перед MWS, SP-API подвергается критике со стороны сообщества разработчиков:

• Сложность миграции — многие приложения, особенно старые, требуют полного переписывания кода, так как формат данных и аутентификация полностью изменились.
• Высокая стоимость — для работы с API необходима учётная запись AWS, что влечёт затраты на вычислительные ресурсы (Lambda, S3, API Gateway), если приложение использует асинхронные методы.
• Ограничения по квотам — малые и средние продавцы часто сталкиваются с ошибками 429, что мешает оперативному обновлению данных.
• Неполнота документации — Amazon регулярно обновляет спецификации, но некоторые конечные точки описаны неполно (особенно в области ошибок и исключительных ситуаций).
• Отсутствие поддержки некоторых функций MWS — не все возможности MWS перенесены в SP-API (например, некоторые операции по управлению рекламными кампаниями остались только в MWS до его окончательного отключения).

Будущее

Amazon продолжает развивать SP-API, добавляя новые под-API (например, для работы с дефицитом товаров, управления претензиями по гарантии), улучшая документацию и производительность. Ожидается, что SP-API станет основой для всех будущих интеграций с Amazon — как для продавцов, так и для вендоров (поставщиков первого уровня). Продавцы, не перешедшие на SP-API, после полного отключения MWS потеряют возможность автоматизации и вынуждены будут работать через веб-интерфейс Seller Central в ручном режиме.

Источники:

• Amazon Selling Partner API Documentation (developer-docs.amazon.com/sp-api)
• Amazon MWS to SP-API Migration Guide (developer-docs.amazon.com/sp-api/docs/migration-guide)
• AWS Identity and Access Management (IAM) User Guide
• OAuth 2.0 Authorization Framework for Amazon SP-API