Токен WB (API ключ Wildberries) — это строка символов, которая позволяет сторонним инструментам безопасно получать данные из вашего кабинета продавца. В этом руководстве: что такое токен WB, где его найти в кабинете, как создать, что делать при ошибке «ошибка при проверке токена вб» и как безопасно использовать API ключ.
Токен WB — это цифровой пропуск, который вы выдаёте приложению или сервису, чтобы тот мог работать с вашим кабинетом Wildberries. Вместо того чтобы давать стороннему инструменту логин и пароль (что небезопасно), вы создаёте специальный ключ — токен — с конкретными правами доступа.
Это похоже на гостевую карточку в отель: вы решаете, в какие комнаты пускать гостя, и в любой момент можете заблокировать карточку, не меняя свой основной ключ.
Важно: токен WB показывается только один раз в момент создания. Если вы его не скопировали и закрыли страницу — придётся создавать новый. Храните токен в надёжном месте.
Технически токен WB — это JWT (JSON Web Token): длинная строка в формате eyJ..., которая содержит в зашифрованном виде идентификатор продавца и список прав доступа.
Токен WB создаётся и управляется в личном кабинете продавца на seller.wildberries.ru. Ниже — полная пошаговая инструкция.
Откройте seller.wildberries.ru и войдите в свой аккаунт продавца. Убедитесь, что у вас есть доступ к настройкам — для этого нужны права администратора или владельца кабинета.
В верхнем правом углу нажмите на иконку профиля или найдите раздел «Настройки» в боковом меню. Выберите пункт «Доступ к API». Здесь хранятся все созданные вами токены.
На странице «Доступ к API» нажмите кнопку «Создать новый токен». Откроется форма создания. Введите понятное название — например, «EcomConnector» или «Google Таблицы» — чтобы потом было легко понять, для чего этот ключ.
Отметьте галочками разделы, к которым нужен доступ: статистика, заказы, склад, реклама и т.д. Нажмите «Создать». Токен отобразится на экране — скопируйте его сразу, он больше не будет показан в полном виде.
Совет: создавайте отдельный токен для каждого приложения с минимально необходимыми правами. Так, если один токен окажется скомпрометирован, остальные останутся в безопасности.
При создании токена WB вы выбираете набор прав доступа. Права сгруппированы по разделам кабинета:
| Раздел прав | Что открывает | Нужен для |
|---|---|---|
| Статистика | Отчёты по заказам, продажам, возвратам, выплатам | Аналитика, выгрузка данных |
| Контент | Карточки товаров, описания, медиа | Управление каталогом |
| Аналитика | Платная аналитика WB: воронка, поисковые запросы | Маркетинговый анализ |
| Реклама | Рекламные кампании, ставки, расходы | Управление рекламой |
| Склад | Остатки, поставки FBS, приёмка | Управление запасами |
| Цены и скидки | Установка цен, акции, скидки | Ценообразование |
| Маркетплейс | Заказы, статусы, сборочные задания | Обработка заказов |
Для EcomConnector рекомендуемый набор прав: Статистика + Аналитика + Реклама + Склад + Маркетплейс. Это позволяет выгружать все основные отчёты в Google Таблицы.
Эта ошибка появляется в сторонних приложениях (аналитика, CRM, интеграции) при попытке подключиться к WB API с неработающим токеном. Разберём каждую причину по отдельности.
Самая распространённая причина. При копировании токена из браузера или письма часто захватываются пробелы в начале или конце строки. API WB не принимает токен с лишними символами.
Решение: при вставке токена в приложение убедитесь, что нет пробелов в начале и конце. Удобнее всего скопировать токен, вставить в текстовый редактор, проверить визуально и только потом использовать.
Токены WB могут быть деактивированы вручную (если вы или кто-то с доступом к кабинету удалил токен) или при изменении настроек безопасности аккаунта.
Решение: зайдите в seller.wildberries.ru → «Настройки» → «Доступ к API» и проверьте, активен ли токен. Если нет — создайте новый.
Если приложению нужны данные раздела «Статистика», а токен создан только с правами «Контент» — будет ошибка авторизации. WB разграничивает права по разделам.
Решение: создайте новый токен с нужными разделами прав. Посмотрите в документации приложения, какие именно права требуются.
Токены WB достаточно длинные (несколько сотен символов). Если строка при копировании оборвалась — токен будет невалидным.
Решение: всегда копируйте токен кнопкой «Копировать» в интерфейсе WB, а не выделением мышью — так захватится полная строка.
Этот вид ошибки возникает в курьерских приложениях WB (например, WB Доставка для курьеров), а не в кабинете продавца. Здесь другая природа проблемы:
Важно: не путайте токен продавца (API ключ для интеграций) и токен курьера (для курьерских приложений). Это принципиально разные ключи для разных систем.
Обновить токен — значит создать новый и заменить им старый во всех приложениях, которые его используют. Само по себе WB не «обновляет» токены — только создаёт новые и удаляет старые.
В seller.wildberries.ru → «Настройки» → «Доступ к API» → «Создать новый токен». Укажите те же или новые права.
В каждом инструменте, который использует старый токен, замените его на новый. Убедитесь, что всё работает корректно.
После того как новый токен работает везде — удалите старый в кабинете WB. Это нейтрализует любой риск от его утечки.
Токен WB — это JWT (JSON Web Token). Формат JWT состоит из трёх частей, разделённых точкой: заголовок, полезная нагрузка (payload) и подпись. Первые две части закодированы в Base64 и легко декодируются.
Если вставить токен WB на сайте jwt.io в поле декодирования, в разделе Payload можно увидеть:
Декодирование — безопасно? Декодирование JWT показывает только открытую часть токена — полезную нагрузку. Подпись при этом не раскрывается. Но саму строку токена не стоит вводить на сторонних сайтах: используйте только jwt.io или offline инструменты.
Декодирование полезно для диагностики: вы можете проверить, какие права действительно вшиты в токен, не заходя в кабинет WB. Это помогает быстро понять, почему одни API-запросы работают, а другие возвращают ошибку 401.
API токен WB — это секретный ключ с доступом к данным вашего магазина. Его утечка может привести к потере данных или несанкционированным действиям от имени вашего аккаунта.
При подключении WB к Google Таблицам через EcomConnector ваш токен используется следующим образом:
Рекомендация: создайте отдельный токен WB специально для EcomConnector с правами: Статистика, Аналитика, Реклама, Склад, Маркетплейс. Это достаточно для всех отчётов и безопаснее, чем использовать токен с полными правами.
Вставьте токен WB один раз — данные будут обновляться автоматически.
Установить EcomConnectorЕсли вы работаете на Ozon, то для интеграции используется другой тип токена. В отличие от WB, Ozon требует два параметра:
| Параметр | Что это | Где найти |
|---|---|---|
| Client ID | Числовой идентификатор вашего кабинета Ozon | seller.ozon.ru → Настройки → API ключи |
| API Key | Длинная строка — секретный ключ для API запросов | seller.ozon.ru → Настройки → API ключи → «Сгенерировать ключ» |
Подробная инструкция по получению токена Ozon, типам ключей (Seller, Admin, Performance) и решению ошибок — в отдельной статье: API ключ Ozon: где найти и как использовать.
Читайте также: API ключ Ozon: где найти и как использовать · Интеграция WB с Google Таблицами · Выгрузка отчётов WB