Содержание страницы
Wildberries API предоставляет продавцам возможность управления магазином и получения оперативной и статистической информации по протоколу HTTP RestAPI.
Описание API предоставляется в формате Swagger (Open API) и может быть использовано для импорта в другие инструменты (такие как PostMan) или генерации клиентского кода на различных языках программирования с помощью Swagger CodeGen
- Описание в оригинальном swagger-формате swagger
- OpenAPI-файл swagger.yaml
Для ручной проверки API вы можете использовать:
Интеграция по API
Для настройки интеграции Вы можете воспользоваться тестовым контуром сервиса статистики.
Авторизация осуществляется по токену типа Статистика, см. раздел Авторизация.
Для параметров dateFrom и dateTo доступен диапазон 4 месяца назад от текущей даты.
Для доступа к тестовому контуру вместо адреса https://statistics-api.wildberries.ru используйте https://statistics-api-sandbox.wildberries.ru или https://statistics-api-sandbox.wb.ru.
Данные в тестовом контуре сгенерированы случайным образом и не пренадлежат реальным продавцам.
Использование тестового контура не несёт риска непреднамеренного раскрытия информации.
Ошибки в получаемой информации по API
Метод позволяет отредактировать несколько карточек за раз.
Редактирование КТ происходит асинхронно, после отправки запрос становится в очередь на обработку.
Важно: Баркоды (skus) не подлежат удалению или замене. Попытка заменить существующий баркод приведет к добавлению нового баркода к существующему.
Если запрос прошел успешно, а информация в карточке не обновилась, значит были допущены ошибки и карточка попала в «Черновики» (метод cards/error/list) с описанием ошибок.
Необходимо исправить ошибки в запросе и отправить его повторно.
Для успешного обновления карточки рекомендуем Вам придерживаться следующего порядка действий:
1. Сначала существующую карточку необходимо запросить методом cards/filter.
2. Забираем из ответа массив data.
3. В этом массиве вносим необходимые изменения и отправляем его в cards/update
Генерация API-токенов
Авторизация осуществляется по токенам API, которые владелец личного кабинета (главный пользователь) самостоятельно генерирует в разделе Профиль —> Настройки —> Доступ к API.
Существует три типа токенов:
- Стандартный. Используется для работы с методами из разделов: Цены, Промокоды и скидки, Контент, Marketplace, Рекомендации, Отзывы, Вопросы.
- Статистика. Используется для работы с методами из раздела Статистика.
- Реклама. Используется для работы с методами из раздела Реклама.
Обратите внимание, что токен отображается ТОЛЬКО в момент создания. Его надо сохранить, потому что больше его отобразить будет нельзя.
Созданный токен следует добавлять в каждый запрос, прибавляя к запросу заголовок (http-header) формата Authorization: ..........
Обращаем ваше внимание, что интеграции с Порталом Продавца, не использующие Публичное API, противоречат пункту 9.7.6 оферты.
Тем не менее, при отсутствии прямой угрозы утечки данных из личного кабинета продавца Wildberries заранее уведомит продавца о запланированной блокировке, связанной с этим пунктом, давая возможность отключить интеграцию.