Расшифровка кодов ошибок WB API
Все HTTP-коды ошибок с описанием, причинами и решениями
Дата обновления: 03.04.2026
Общие коды ошибок HTTP
WB API использует стандартные HTTP-коды статуса. Успешные ответы обозначаются кодами 2XX, ошибки — кодами 4XX и 5XX.
Обращайте внимание на поле detail в теле ответа — API добавляет туда конкретную причину ошибки и рекомендации. Особенно полезно для ошибок 404 и 429.
| Код | Описание | Категория |
|---|---|---|
| 200 | Успех | Запрос выполнен, данные в теле ответа |
| 201 | Создано | Ресурс успешно создан |
| 202 | Принято | Запрос принят, данные на обработке |
| 204 | Удалено / Обновлено / Подтверждено | Действие выполнено, тело ответа пустое |
| 400 | Некорректный запрос | Ошибка в синтаксисе или параметрах |
| 401 | Не авторизован | Проблема с токеном |
| 402 | Требуется оплата | Недостаточно средств на балансе сервиса из Каталога решений |
| 403 | Доступ запрещён | Недостаточно прав |
| 404 | Не найдено | Неверный URL или ресурс не существует |
| 406 | Операция не допускается | Действие заблокировано |
| 409 | Конфликт | Данные противоречат требованиям |
| 413 | Тело запроса слишком большое | Слишком много объектов |
| 422 | Ошибка обработки параметров | Данные противоречат друг другу |
| 429 | Слишком много запросов | Превышен лимит |
| 451 | Контент недоступен по юридическим причинам | Файл не прошёл модерацию |
| 5XX | Ошибка сервера | Сервис недоступен |
Ошибки авторизации
401 Unauthorized — проблема с токеном
Запрос не прошёл авторизацию. Возможные причины: токен отсутствует или передан с ошибкой, токен истёк (прошло 180 дней), токен повреждён, токен отозван, сменился владелец кабинета.
Что делать: проверьте заголовок Authorization: Bearer ваш_токен. Декодируйте токен в инструменте декодирования, чтобы проверить статус и срок действия. При необходимости создайте новый токен.
403 Forbidden — недостаточно прав
Токен валиден, но не имеет прав на выполнение операции. Возможные причины: категория токена не соответствует вызываемому методу, токен только на чтение, Персональный токен используется с облачным сервисом, токен создан удалённым пользователем, не оформлена подписка на Джем (для методов монетизации).
Что делать: сверьте категорию токена с методом в документации. Проверьте уровень доступа. Если используете методы Джема — проверьте подписку в личном кабинете WB Партнёры. При необходимости создайте новый токен с нужными настройками.
Подробнее — в статье «Ошибки авторизации WB API и их решение»
Ошибки запросов
400 Bad Request — некорректный запрос
Запрос содержит синтаксическую ошибку или невалидные параметры.
Что делать: проверьте синтаксис запроса, формат JSON, типы данных в параметрах. Сравните с примером из документации.
402 Payment Required — требуется оплата
На балансе сервиса из Каталога решений для бизнеса на Wildberries недостаточно средств.
Что делать: пополните баланс сервиса в личном кабинете. Подробнее о платном доступе — в статье «Платный доступ к WB API».
404 Not Found — не найдено
Указанный URL не существует или ресурс не найден.
Что делать: проверьте правильность URL — домен, путь, версию метода. Обратите внимание на поле detail в ответе — API подсказывает, куда обратиться за документацией.
409 Conflict — конфликт данных
Данные в запросе не соответствуют требованиям сервиса.
Что делать: проверьте данные запроса и убедитесь, что они соответствуют текущему состоянию объекта.
В некоторых категориях (например, «Маркетплейс») запрос с ошибкой 409 учитывается как несколько обычных запросов при подсчёте лимитов.
413 Request Entity Too Large — слишком большой запрос
Что делать: уменьшите количество объектов в запросе. Разбейте на несколько запросов.
422 Unprocessable Entity — ошибка обработки
Параметры запроса корректны по формату, но противоречат друг другу или бизнес-логике.
Что делать: проверьте, что параметры не противоречат друг другу, и ознакомьтесь с описанием ограничений в документации метода.
Ошибки лимитов
429 Too Many Requests — превышен лимит
Вы отправляете запросы слишком часто.
Что делать: используйте заголовки ответа для определения паузы:
| Заголовок | Описание |
|---|---|
X-Ratelimit-Retry | Через сколько секунд можно повторить |
X-Ratelimit-Reset | Через сколько секунд лимит восстановится полностью |
X-Ratelimit-Limit | Максимальный Burst после восстановления |
Подробнее — в статье «Лимиты запросов WB API»
Серверные ошибки
5XX Internal Server Error — ошибка на стороне сервера
Сервис временно недоступен.
Что делать: повторите запрос через некоторое время. Если ошибка сохраняется — проверьте Статус API. При необходимости создайте обращение в поддержке продавцов Wildberries, категория «Интеграции по API». К обращению приложите:
- Пример запроса (URL, метод, заголовки — без токена)
- Полный ответ с ошибкой (включая
requestId) - Дату и время возникновения ошибки
Форматы сообщений об ошибках
WB API использует два формата ошибок в зависимости от категории API.
При обращении в поддержку приложите полный ответ с ошибкой, включая requestId (формат 1) или code (формат 2).
Что дальше
- Ошибки 401 и 403 подробно разобраны в статье «Ошибки авторизации WB API и их решение» — причины, решения, алгоритм диагностики
- Ошибка 429 и управление нагрузкой — в статье «Лимиты запросов WB API»
- Если API не отвечает или возвращает 5XX — проверьте Статус API и Журнал событий