Общее (general)

Wildberries API предоставляет продавцам инструменты для управления магазином и получения оперативной и статистической информации по протоколу HTTP REST API.

Главное преимущество API — возможность автоматизировать процессы за счет интеграции с информационными системами продавца: например, ERP, WMS, OMS, CRM. С WB API продавец может не управлять магазином через интерфейс сайта вручную.

Использование API для работы с магазином на Wildberries — это отличный способ:

• автоматизировать рутинные процессы
• получить доступ к актуальной информации
• оптимизировать управление ассортиментом

Документация API предоставлена в формате Swagger OpenAPI и может быть использована для импорта в другие инструменты — например, Postman — или генерации клиентского кода на различных языках программирования с помощью Swagger CodeGen.

Для ручного тестирования API вы можете использовать:

• Под ОС Windows — PostMan
• Под ОС Linux — curl

1. Зарегистрируйтесь в личном кабинете Продавца.
2. Перейдите в настройки магазина и создайте API-токен. Токен позволит получить доступ к WB API. Система токенов позволит вам контролировать, кто и как взаимодействует с вашими данными через API.
3. Разработайте интеграцию с API с помощью собственных разработчиков или внешних специалистов. Вы также можете подключить партнёрские сервисы из нашего каталога решений для бизнеса.

Практические советы:

• Используйте документацию.
  Официальная документация WB API поможет разобраться в функциональности и возможностях API. В ней приводятся примеры возможных запросов и ответов, список возможных ошибок, лимиты запросов, правила безопасности и так далее.
• Регулярно проверяйте работу интеграции.
  Следите, корректно ли вы передаете данные и какие вы получаете ответы, чтобы вовремя дорабатывать интеграцию. Не забывайте про ограничения и учитывайте лимиты на количество запросов.
• Храните API-токен в безопасности.
  Не передавайте его третьим лицам без необходимости. Используйте только доверенные сервисы. При обнаружении подозрительной активности немедленно удалите и замените токен.
• При необходимости обращайтесь в техническую поддержку.
• Следите за новостями и изменениями WB API в:
  • журнале изменений
  • Telegram-канале
  • новостной ленте Wildberries

Техническая поддержка происходит через диалоги в личном кабинете продавца. При создании нового обращения в техподдержку используйте категорию API.

Основные статус-коды ответов на запросы в WB API:

Пример ошибки:

{
  "title": "path not found",
  "detail": "Please consult the https://dev.wildberries.ru/openapi/api-information",
  ...
  "status": 404,
  "statusText": "Not Found",
  "timestamp": "2025-04-24T07:25:28Z"
}

В WB API есть ограничения на скорость отправки запросов. Для равномерного распределения нагрузки используется алгоритм token bucket. Лимиты для конкретных методов API указаны в документации.

Например:

Это значит, что за минуту можно отправить 300 запросов. Эти запросы должны быть равномерно распределены по времени. То есть интервал между запросами должен составлять 60 секунд/300 запросов = 0.2 секунды.

API допускает всплески запросов — burst, когда можно одновременно выполнить несколько запросов. Допустимый всплеск возвращается в ответе в заголовке X-Ratelimit-Remaining. Он встречается во всех статусах ответов, кроме ошибки 429.

X-Ratelimit-Remaining — это количество запросов, которое можно выполнить на данный момент без добавления задержек. После каждого запроса значение X-Ratelimit-Remaining уменьшается на единицу. Если X-Ratelimit-Remaining равен 0 и следующий запрос вы сделали, не подождав, в ответ вы получите ошибку 429. Значение X-Ratelimit-Remaining восстанавливается со временем.

Если вы превысите скорость выполнения запросов, вы получите ошибку 429. В этом случае следующий запрос вы сможете сделать только после небольшого ожидания. Чтобы понять, сколько времени вам нужно ждать, используйте заголовки ответа 429:

• X-Ratelimit-Retry — через сколько секунд вы можете повторить запрос. Если вы сделаете попытку раньше, вы все равно будете получать ошибку 429.
• X-Ratelimit-Limit — максимальное значение всплеска запросов — burst, которое будет восстановлено через X-Ratelimit-Reset секунд.
• X-Ratelimit-Reset — через сколько секунд допустимый всплеск запросов восстановится до максимального значения, указанного в X-Ratelimit-Limit.

Пример ответа:

HTTP/1.1 429 Too Many Requests
...
X-Ratelimit-Reset: 29
X-Ratelimit-Retry: 2
...
X-Ratelimit-Limit: 10

Чтобы авторизоваться в API, вам понадобится токен. Он действует 180 дней после создания. Добавляйте токен в заголовок запроса Authorization.

1. В личном кабинете нажмите на имя профиля и выберите Настройки → Доступ к API.
2. Если нужно, выберите опцию:
   • Тестовый контур: с токеном можно работать только в тестовом контуре (песочнице).
   • Только на чтение: с токеном нельзя ничего изменять, только получать данные. Работает для реальных данных и в тестовом контуре.
3. Выберите, с какими категориями API вы будете работать с этим токеном.

4. Нажмите Создать токен.
5. Скопируйте и сохраните токен в безопасном месте. Потом его нельзя будет посмотреть в личном кабинете. Если вы потеряли токен, создайте новый.

Токен представляет собой JWT согласно RFC 7519. Чтобы проверить, действителен ли ваш токен и какие категории методов API по нему доступны, вы можете декодировать его.

Публичные поля токена

Поля, которых нет в таблице, служебные, и могут быть удалены.

Поле s

Поле s — это битовая маска, то есть целое число, каждый бит которого означает наличие или отсутствие какого-то свойства.

Подробнее про битовую маску

Значения бит

Позиция бита отсчитывается от 0, где 0 — это младший бит.

Декодирование токена позволяет проверить, является ли токен действительным и к каким категориям методов API имеется доступ. Вы можете декодировать токен на отдельной странице.