Как получить JWT-токен Wildberries для аналитики продаж

Wildberries отдаёт данные селлера через единый JWT-токен. Один токен — и сразу заказы, продажи, остатки, расход на рекламу, карточки. Но у токена есть тонкости: ограниченный срок жизни, несколько категорий доступа и жёсткие лимиты запросов на endpoint. Разбираем по порядку, чтобы подключение прошло с первого раза.

Зачем нужен токен

Через токен внешний сервис получает доступ к API статистики, аналитики, контента и рекламы. Без него вы каждое утро будете руками выгружать Excel-отчёты из ЛК и сшивать их между собой. С токеном — данные подтягиваются автоматически, и вы видите выручку, чистую прибыль и ДРР в одном окне без копипасты.

Где создать токен

Откройте кабинет seller.wildberries.ru → ваш профиль (правый верхний угол) → «Настройки» → «Доступ к API». Нажмите «Создать новый токен». WB попросит ввести имя токена (например, «VelesRadar») и выбрать категории. Готовый токен — длинная строка из трёх частей, разделённых точками, — показывается один раз. Скопируйте и сохраните сразу, иначе придётся создавать новый.

Какие категории выбрать

Для полной аналитики нужны четыре категории: «Контент» (карточки и атрибуты SKU), «Статистика» (заказы, продажи, остатки, отчёт о реализации), «Аналитика» (воронка, ниши, метрики) и «Продвижение» (расход на рекламу, ставки, кампании). Под чек-боксом каждой категории есть переключатель «Только на чтение» — мы рекомендуем включить его для всех. Запись WB не требуется ни для одной аналитической задачи, и read-only режим даёт гарантию, что ничего не изменится в карточках или ставках без вашего ведома.

Срок жизни — 180 дней

Wildberries выдаёт токены со сроком 180 дней. После этого API начнёт отвечать 401 — данные перестанут обновляться. Документация и текущие сроки описаны в официальном портале WB API. Чтобы не ловить «тишину» в аналитике, VelesRadar следит за сроком и за 7 дней до истечения шлёт email с напоминанием перевыпустить токен. Процедура та же: создаёте новый, удаляете старый, вставляете в VelesRadar — старые данные при этом не теряются.

Куда вставить в VelesRadar

В VelesRadar: «Магазины» → «Добавить магазин», в селекте «Маркетплейс» — Wildberries. Поле всего одно — сам JWT. Вставили, нажали «Подключить магазин», и если статус «OK», начинается первичная синхронизация: исторические продажи за 30 дней, актуальные остатки и кампании. Дальше токен расшифровывается только в момент обращения к API. Полный список шагов по подключению маркетплейсов — на странице интеграции.

Безопасность

JWT даёт доступ ко всему, что разрешено категориями, поэтому к нему нужно относиться как к паролю. Не отправляйте в чаты и не храните в Excel-файлах на общем диске. В VelesRadar токены лежат в зашифрованном виде (AES-256-GCM), расшифровка происходит в памяти на время запроса. Подробнее о хранении и доступе — на странице безопасность. Если есть подозрение на утечку — удалите токен в кабинете WB одной кнопкой, и старый ключ моментально перестанет работать.

Частые проблемы

• 401 Unauthorized — не выбрана нужная категория или токен истёк. Перевыпуск со всеми четырьмя категориями обычно лечит.
• 429 Too Many Requests — нормальное явление: у WB строгие лимиты (порядка одного запроса в минуту на endpoint у аналитических методов). VelesRadar держит свою очередь и распределяет запросы, лимит не превышается.
• «Свежий токен молчит первые часы» — у только что выпущенных токенов часть прокси WB иногда даёт 429 сразу. Не нужно дёргать ретраи: ждите 4–6 часов, потом данные пойдут.
• Отчёт о реализации задерживается — это нормально, WB публикует его раз в неделю по понедельникам за предыдущую неделю.
• Один токен на несколько сервисов — лимиты делятся между всеми. Лучше отдельный токен под каждую интеграцию.

Когда токен живёт, аналитика начинает работать на вас: чистая прибыль по каждому SKU, точка дозаказа, риск out-of-stock и автоматический расчёт юнит-экономики. Подробнее — на странице аналитика Wildberries.

Коротко

• Один JWT-токен закрывает контент, статистику, аналитику и продвижение.
• Включайте все четыре категории в режиме «только на чтение».
• Срок жизни 180 дней — следите за датой выпуска или дайте VelesRadar напоминать.
• 401 — почти всегда категория или срок; 429 — лимиты WB, это норма.
• Не публикуйте токен в чатах, при подозрении на утечку — удалите в ЛК.

VelesRadar умеет работать с JWT WB по правилам: не давит ретраями, держит лимиты, расшифровывает токен только в момент запроса и шлёт напоминание перед истечением. Подключите магазин — Месяц Pro бесплатно, годовая подписка со скидкой −50% до 31 августа.