API-ключ Wildberries: как создать, категории доступа и безопасность
WB API открывает доступ к отчётам, остаткам, ценам и рекламе без ручной выгрузки. Ключ создаётся в кабинете за минуту, но ошибки в категориях доступа — главная причина «нет данных» в сервисах аналитики. Разбираем, как создать API-ключ Wildberries, что отметить и как хранить.
Как создать API-ключ в WB Seller
- Профиль → «Интеграции по API» → «+ Создать токен». Создавать и удалять токены может только владелец профиля.
- Выберите вкладку: «Для сервиса из каталога», если сервис есть в каталоге решений WB, или «Для интеграции вручную» — в остальных случаях.
- Назовите токен по сервису, которому он выдан.
- Отметьте категории доступа (ниже).
- Выберите «только чтение», если сервису не нужно писать.
- Скопируйте токен сразу: повторно он не показывается.
Смотрите также: аналитика wildberries, все гайды, база знаний.
Какие категории доступа отметить
| Категория | Что открывает | Для чего |
|---|---|---|
| Статистика | отчёты реализации, продажи, остатки | аналитика прибыли |
| Аналитика | воронка, выкуп, поисковые запросы | РНП, трекер |
| Контент | карточки | создание и перенос карточек |
| Цены и скидки | прайс | репрайсер |
| Продвижение | кампании и ставки | биддер и аналитика рекламы |
| Отзывы и вопросы | отзывы | автоответы |
| Маркетплейс (ФБС) | заказы и остатки ФБС | склад и заказы |
| Поставки | заявки | планирование поставок |
Токен «только чтение»
Для аналитики достаточно чтения. Запись нужна репрайсеру, биддеру, автоответам и созданию карточек: с токеном «только чтение» они увидят данные, но не смогут отправить цену или ответ. У каждого юрлица свой кабинет и свой токен.
Как хранить ключ
- Отдельный токен на каждый сервис, чтобы отзывать точечно.
- Не пересылайте токен в чатах; сервис хранит его зашифрованным — как это устроено.
- Токен действует 180 дней, за 3 дня до конца WB присылает уведомление: заведите напоминание о перевыпуске заранее.
- Ушёл сотрудник — отзовите его токены.
Если сервис не видит данные
- «Неверный токен» — скопирован не полностью или создан в другом кабинете.
- «Нет доступа к методу» — не отмечена категория.
- Пусто в рекламе или отзывах — добавьте «Продвижение» и «Отзывы» и замените токен в сервисе — подключение WB.
Попробуйте на своих данных
Подключите API-ключ магазина — первые цифры появятся уже через минуту. Первые 7 дней — бесплатно · без привязки карты.
Попробовать 7 дней бесплатноWB Seller API: что это, какой токен выбрать и где документация
WB Seller API (WB API) — программный интерфейс Wildberries, через который сервисы и собственные программы продавца обмениваются данными с магазином: получают заказы, остатки, отчёты и статистику рекламы, отправляют цены, остатки и ответы на отзывы. Подключают его двумя способами: токеном, который владелец кабинета создаёт в разделе «Интеграции по API», или по OAuth 2.0 — если сервис есть в каталоге готовых решений WB и поддерживает этот способ, токен вручную передавать не нужно.
При создании токена WB предлагает четыре типа:
| Тип токена | Для чего | Особенности |
|---|---|---|
| Сервисный | облачный сервис из каталога решений WB | категории доступа заполняются сами, токен работает только с выбранным сервисом |
| Персональный | свои программы и коробочные системы на своих серверах, например локальная 1С | нельзя передавать облачным сервисам |
| Базовый | тесты на реальных данных и случаи, когда другие типы не подходят | категории и уровень доступа — «только чтение» или «чтение и запись» — выбираете сами |
| Тестовый | разработка и отладка в песочнице WB API | реальные данные магазина недоступны |
Любой токен показывается только один раз — сохраните его сразу; на один магазин можно держать до 20 активных токенов. Документация WB API лежит на портале для разработчиков dev.wildberries.ru: описание методов по категориям, песочница и статус работы API. Продавцу, который подключает готовый сервис, документация не нужна; она пригодится, если интеграцию пишет свой программист — например, для обмена учётной системы с Wildberries.
Официальные источники
Правила и тарифы меняются: сверяйте цифры с первоисточниками.
Частые вопросы
Это программный интерфейс Wildberries для обмена данными магазина со сторонними сервисами и собственными программами. Документация — на портале для разработчиков dev.wildberries.ru, там же песочница для тестов и статус работы API.