Общее (general)

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

Описание API предоставляется в формате Swagger (Open API) и может быть использовано для импорта в другие инструменты (такие как PostMan) или генерации клиентского кода на различных языках программирования с помощью Swagger CodeGen.

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

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

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

Новости и изменения, касающиеся API, публикуются в новостной ленте Wildberries и Telegram-канале.

В 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 имеется доступ. Вы можете декодировать токен на отдельной странице.