Что такое токен в Вайлдберриз
Коротко
Токен в Вайлдберриз — цифровой ключ, который открывает сторонним программам и сервисам доступ к данным магазина продавца на портале WB Partners. Продавец сам выпускает его в личном кабинете, сам выбирает категории данных и уровень доступа, а подключаемая система прикладывает эту строку к каждому запросу к API.
Зачем продавцу токен
Через личный кабинет продавец работает руками: открывает отчёты, смотрит остатки, меняет цены. Когда магазин растёт, часть этой работы передают программам — своей разработке, коробочной 1С, сервису аналитики или учёта. Чтобы программа могла читать заказы, товары, цены и аналитику, ей нужен ключ. Этот ключ и есть токен.
Второй способ подключения — OAuth 2.0: продавец выбирает сервис из каталога и подтверждает доступ, без копирования строк. Wildberries называет его более удобным и безопасным и советует брать именно его, если сервис его поддерживает. Токен остаётся для своих программ, решений, установленных на собственных серверах, и для сервисов, которые OAuth 2.0 не поддерживают.
Токен — это не пароль от личного кабинета и не отдельная подписка. Он даёт системе ровно те права, которые продавец отметил при выпуске: например, только читать товары и заказы или ещё и менять цены.
Какие бывают типы токенов
- Персональный — для собственных программ и коробочных решений на своей инфраструктуре, включая 1С. Даёт расширенный доступ к категориям данных, но с облачными сервисами не работает.
- Сервисный — для облачного сервиса из каталога решений Wildberries. Привязан к одному сервису, настройки заполняются автоматически, продавцу остаётся подтвердить создание.
- Базовый — универсальный вариант, когда персональный и сервисный не подходят. Категории данных и права доступа продавец выбирает сам.
- Тестовый — для разработки и отладки в песочнице API. Работает только с тестовым контуром и реальных данных магазина не касается.
Как выпустить токен
Токен создают в личном кабинете WB Partners, в разделе интеграций по API. Создавать и удалять токены может только владелец личного кабинета — сотрудник с другим доступом этого не сделает.
При выпуске продавец выбирает тип токена, категории данных и уровень доступа: только чтение или чтение и запись. Уровень записи разрешает программе менять данные магазина, поэтому его дают только тем сервисам, которым это действительно нужно.
Готовую строку показывают один раз. Её копируют целиком, без лишних пробелов и переносов, и сразу сохраняют: восстановить прежний токен нельзя, при утере выпускают новый. Обрезанная при копировании строка — самая частая причина того, что первый же запрос возвращает ошибку 401: API не принял ключ.
Сколько живёт токен и что будет потом
Срок действия одного токена — 180 дней. За это время его нужно перевыпустить и обновить в интеграции, иначе сервис или своя программа потеряют доступ к данным магазина.
При смене номера телефона владельца личного кабинета все токены перестают корректно работать, и их создают заново. Это стоит держать в голове, если номер меняется в разгар сезона.
Wildberries советует выпускать отдельный токен под каждую новую интеграцию: так проще управлять доступами и отключать их по одному, не задевая остальные системы.
Токен — это пароль от бизнеса
Токен открывает данные магазина: товары, заказы, цены, аналитику. С ним обращаются как с паролем — не пересылают в общих чатах, не хранят в скриншотах и открытом коде, не оставляют в логах.
Доступ отзывают удалением токена. Но удаление затрагивает все системы, где этот токен прописан, поэтому отдельный ключ под каждую интеграцию экономит нервы: отключая старый сервис, продавец не ломает работу остальных.
Не путайте токен WB API с внутренним ключом сайта wildberries.ru. Библиотеки, которые работают через внутреннее API покупательского сайта, добывают ключ из браузера, и живёт он около двух недель. К официальной интеграции продавца это отношения не имеет, а такие сборы ключей нарушают правила площадки.
Частые вопросы
Токен в Вайлдберриз — это то же самое, что пароль от личного кабинета?
Нет. Пароль открывает весь кабинет, а токен — только те категории данных и тот уровень доступа, которые продавец отметил при выпуске. Пароль продавец никому не передаёт, а токен передают подключаемой программе или разработчику.
Кто может создать токен?
Только владелец личного кабинета. Создание и удаление токенов — его право, другие сотрудники этого сделать не могут.
Сколько действует токен?
180 дней с момента выпуска. Потом его перевыпускают и обновляют в интеграции, иначе доступ к данным магазина пропадёт.
Чем токен отличается от подключения через OAuth 2.0?
Токен продавец создаёт и передаёт в систему сам, он действует 180 дней. При OAuth 2.0 продавец выбирает сервис из каталога и подтверждает доступ, а обновляется он автоматически и срока в 180 дней не имеет. Wildberries рекомендует OAuth 2.0 для облачных сервисов из каталога.
Почему запрос возвращает ошибку 401?
API не принял токен, и запрос не дошёл до данных. Чаще всего строка скопирована не целиком, с лишним пробелом или переносом, либо срок токена истёк, либо он удалён.
Что будет, если токен попадёт к постороннему?
Посторонний получит доступ к тем данным магазина, которые разрешены этому токену, а при уровне «чтение и запись» сможет их менять. Такой токен удаляют в личном кабинете и выпускают новый, а интеграцию перенастраивают.
Нужен ли токен, если работаю с сервисом из каталога Wildberries?
Для облачного сервиса из каталога достаточно подключения через OAuth 2.0. Токен нужен, когда сервис OAuth 2.0 не поддерживает, когда программа установлена на собственных серверах или когда интеграцию пишут сами.
Когда токены и сервисы уже подключены
Чтобы видеть, сколько бизнес зарабатывает на каждом товаре и канале
Токены и интеграции дают данные: заказы, остатки, цены, отчёты площадки. Сами по себе они не отвечают на вопрос, какой товар приносит прибыль после комиссии, логистики, рекламы и налогов, а какой тянет бизнес вниз.
Я собираю юнит-экономику по каждому товару и каналу, считаю точку безубыточности и финансовую модель, по которой видно, что будет с деньгами при изменении цен, ассортимента и рекламы.