Я работаю с API Wildberries в проектах автоматизации: отчёты в Google Sheets, остатки по складам, ответы на отзывы и сообщения покупателей. Ниже — практическое руководство. Официальная документация — dev.wildberries.ru; её правила меняются, поэтому сверяйтесь с ней на дату.
Как создать токен
- Зайдите в личный кабинет продавца под владельцем или сотрудником с правом на интеграции.
- Откройте настройки → раздел доступа к API (интеграции по API).
- Нажмите «Создать токен», выберите тип, категории доступа и, если можно, режим «только на чтение».
- Скопируйте токен: полностью он показывается только при создании.
- Запишите дату окончания срока действия и поставьте напоминание — по истечении срока токен перестанет работать, а скрипты — вместе с ним.
Типы токенов
| Тип | Для чего | Особенности |
|---|---|---|
| Базовый | Простые интеграции | Самые жёсткие лимиты на ряд методов. В моём проекте метод чата с покупателями был доступен раз в час |
| Персональный | Ваши собственные скрипты и интеграции | Лимиты выше: чат — 10, отзывы — 6 в заголовке ответа о лимите. У нашего токена, выпущенного в октябре 2026 года, срок действия — до апреля 2027 года |
| Сервисный | Для внешних сервисов, работающих с многими продавцами | Требует регистрации сервиса у Wildberries |
| Тестовый | Песочница для разработки | Не работает с боевыми данными |
Лимиты — по заголовкам X-Ratelimit-Limit в ответах API на нашем аккаунте в октябре 2026 года. Для разных методов и аккаунтов они могут отличаться: точные значения смотрите в документации и в заголовках ответа.
Категории доступа
При создании токена выбираются категории: контент, аналитика, цены и скидки, маркетплейс, статистика, продвижение, вопросы и отзывы, чат с покупателями, возвраты, документы, финансы и другие. Правило простое — давайте токену только то, что нужно задаче:
- отчёт о продажах и остатках — статистика и аналитика, только на чтение;
- ответы на отзывы — вопросы и отзывы;
- общение с покупателями — чат с покупателями;
- обработка возвратов — категория возвратов. Без неё метод заявок на возврат отвечает 403 — так было и в моём проекте, пока категорию не добавили.
Лимиты и как их не превышать
- Смотрите заголовки ответа:
X-Ratelimit-LimitиX-Ratelimit-Remainingпоказывают лимит и остаток. - На ответ 429 — пауза и повтор с увеличивающимся интервалом.
- Лимит общий на токен: если несколько процессов используют один токен, они делят лимит.
- Тяжёлые отчёты запрашивайте реже и кэшируйте результат.
Безопасность
- Токен — это доступ к вашему кабинету. Не пересылайте его в мессенджерах и не вставляйте в чужие расширения браузера.
- Для чтения — токены «только на чтение».
- Отдельный токен на каждую интеграцию: если один утёк, отзываете только его.
- Храните токен в переменных окружения сервера, не в коде и не в таблицах.
Что можно автоматизировать на API маркетплейсов: отчётность в Google Sheets.
Частые вопросы
Как получить API-ключ Wildberries?
В личном кабинете продавца в разделе доступа к API: создать токен, выбрать тип и категории доступа, скопировать его сразу после создания.
Какой токен выбрать для своих отчётов?
Персональный, с категориями статистики и аналитики в режиме «только на чтение».
Сколько действует токен Wildberries?
Ограниченный срок, дата окончания видна в кабинете. У нашего персонального токена — около полугода. Ставьте напоминание о замене заранее.
Почему API Wildberries отвечает 403?
Чаще всего у токена нет нужной категории доступа, истёк срок или токен отозван.