Если вы продавец на Wildberries и планируете автоматизировать работу с заказами, отчётами или аналитикой через API, вам потребуется **имя токена**. Без этого параметра подключение внешних сервисов (1С, CRM, аналитических платформ) просто невозможно. Многие сталкиваются с проблемой: документация Wildberries описывает процесс поверхностно, а в личном кабинете нет очевидной кнопки «Получить токен». В результате теряется время на поиски, а иногда — и доступ к важным данным.
На практике имя токена — это уникальный идентификатор, который связывает ваш аккаунт с внешними системами. Его часто путают с самим токеном (секретным ключом), но это два разных параметра. Без правильного имени токена даже корректный ключ не сработает. Вот что нужно сделать, чтобы избежать ошибок: разобраться в терминологии, найти параметр в личном кабинете и научиться его применять.
Важный момент: имя токена не равно паролю от личного кабинета. Это технический параметр, который генерируется автоматически и не меняется со временем (если не пересоздавать токен). Его не нужно хранить в секрете — в отличие от самого токена, который требует защиты как банковский PIN.
Что такое имя токена и зачем оно нужно
Разница между именем токена и самим токеном
Имя токена и токен (секретный ключ) — это две части одной системы аутентификации в API Wildberries. Вот их ключевые отличия:
- Имя токена — публичный идентификатор, который указывается в запросах к API. Он нужен, чтобы Wildberries понял, от какого продавца пришёл запрос. Пример:
dev-12345678-9abc-def0-1234-56789abcdef. - Токен (секретный ключ) — закрытый пароль, который подтверждает подлинность запроса. Его нельзя передавать третьим лицам. Пример:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....
На практике имя токена используется:
- В настройках подключения внешних сервисов (например, в 1С:Предприятие или МойСклад).
- В заголовках HTTP-запросов к API Wildberries (параметр
Authorization). - Для идентификации продавца в логах системы (если возникают ошибки).
Когда требуется имя токена
Без имени токена невозможно:
- Автоматически выгружать заказы в CRM или ERP-систему.
- Получать данные по остаткам, ценам или отзывам через API.
- Настраивать интеграцию с сервисами аналитики (например, Wildberries Analytics или Retail Rocket).
- Отправлять уведомления о статусах заказов в мессенджеры (Telegram, WhatsApp).
Если вы только начинаете работать с API, имя токена понадобится уже на этапе тестирования. Например, чтобы проверить запрос на получение списка заказов:
GET https://suppliers-api.wildberries.ru/api/v3/orders
Headers:
Authorization: ИМЯ_ТОКЕНА СЕКРЕТНЫЙ_КЛЮЧ
Где найти имя токена в личном кабинете Wildberries
Пошаговая инструкция для продавцов
Имя токена скрыто в разделе API личного кабинета. Вот как его найти:
📋 Поиск имени токена
Откройте личный кабинет Wildberries для продавцов и авторизуйтесь.
В левом меню выберите раздел API (находится в блоке Инструменты).
Нажмите на вкладку Токены API. Если токен ещё не создан, система предложит его сгенерировать.
В таблице с токенами найдите колонку Имя токена — это и есть нужный параметр. Скопируйте его (например,
wb-seller-12345678-9abc).
Важный момент: если у вас несколько токенов (например, для тестового и боевого режимов), у каждого будет своё имя. Убедитесь, что копируете имя того токена, который используете в интеграции.
Имя токена иногда требуется для настройки вебхуков (уведомлений о изменениях заказов). Также его просят технические поддержки сервисов-интеграторов, если возникают ошибки подключения.Где ещё может пригодиться имя токена?
Что делать, если раздела API нет в меню
Если в личном кабинете нет раздела API, проверьте:
- Ваш статус продавца. API доступен только для подтверждённых аккаунтов с действующими товарами в продаже.
- Регион работы. На некоторых иностранных площадках Wildberries (например, в Казахстане или Белоруссии) функционал API может отличаться.
- Права доступа. Если вы работаете от имени компании, у вашего пользователя должны быть права на управление API (настраивается в разделе Сотрудники).
Если раздел всё равно отсутствует, обратитесь в техническую поддержку Wildberries с уточнением: «Почему в моём личном кабинете нет раздела API для генерации токенов?».
Как использовать имя токена на практике
Примеры интеграции с популярными сервисами
Имя токена требуется при настройке большинства интеграций. Вот типичные сценарии:
| Сервис | Где указывать имя токена | Пример поля |
|---|---|---|
| 1С:Предприятие | Настройки обмена с Wildberries | Идентификатор клиента (Client ID) |
| МойСклад | Подключение маркетплейса → Wildberries | API Key Name или Token Name |
| Retail Rocket | Источники данных → Wildberries API | Supplier Token ID |
| Zoho CRM | Настройки вебхуков | WB Token Identifier |
Например, в 1С путь будет таким:
Администрирование → Печатные формы, отчёты и обработки → Обмен с Wildberries → Настройки подключения.
В поле Идентификатор клиента вставляете скопированное имя токена.
Формат запросов к API с именем токена
В большинстве случаев имя токена передаётся в заголовке запроса вместе с секретным ключом. Пример для запроса списка заказов:
GET https://suppliers-api.wildberries.ru/api/v3/orders
Headers:
Authorization: ИМЯ_ТОКЕНА СЕКРЕТНЫЙ_КЛЮЧ
Content-Type: application/json
Важные нюансы:
- Имя токена и секретный ключ разделяются пробелом (не запятой или другим символом).
- В некоторых сервисах имя токена может называться
Client-IDилиToken-ID. - Если запрос возвращает ошибку
401 Unauthorized, проверьте:- Правильность имени токена (нет ли лишних пробелов).
- Актуальность секретного ключа (токены могут истекать).
- Права токена (например, он может быть ограничен только чтением заказов).
Типичные ошибки при работе с именем токена
Даже опытные продавцы иногда допускают ошибки при использовании имени токена. Вот самые распространённые:
- Путают имя токена с секретным ключом. Имя токена — это публичный идентификатор, а ключ — закрытая информация. Если передать ключ вместо имени (или наоборот), интеграция не заработает.
- Копируют имя токена с пробелами. При копировании из личного кабинета иногда захватываются лишние символы. Всегда проверяйте начало и конец строки.
- Используют старый токен. Если вы пересоздали токен в личном кабинете, его имя тоже изменится. Все интеграции придётся обновлять.
- Не проверяют права токена. Например, токен может быть настроен только на чтение заказов, а вы пытаетесь через него обновить цены. В этом случае API вернёт ошибку
403 Forbidden.
Если интеграция не работает, сделайте следующее:
- Проверьте, что имя токена скопировано без ошибок.
- Убедитесь, что секретный ключ актуален (не истёк).
- Сверьте права токена в личном кабинете (API → Токены API → Редактировать).
- Проверьте формат запроса (особенно разделитель между именем токена и ключом).
Чек-лист: как избежать проблем с именем токена
Чтобы не тратить время на поиск ошибок, используйте этот чек-лист при настройке интеграций:
☑️ Подготовка к работе с API Wildberries
Если после всех проверок интеграция не заработала, обратитесь в поддержку сервиса, с которым настраиваете связь. Предоставьте им:
- Имя токена (можно открыто).
- Описание ошибки (текст или скриншот).
- Пример запроса (без секретного ключа!).
Почему имя токена — это основа безопасной автоматизации
Имя токена — это не просто технический параметр, а часть системы безопасности Wildberries. Оно позволяет платформе отслеживать, какие запросы приходят от вашего аккаунта, и блокировать подозрительную активность. Например, если с одного имени токена suddenly пойдёт тысяча запросов в секунду, Wildberries может временно заблокировать доступ.
На практике это означает:
- Вы можете отзывать компрометированные токены, не меняя логин/пароль от личного кабинета.
- Wildberries видит, какой именно токен использовался для некорректных запросов (это помогает в разборах с поддержкой).
- Вы можете создать несколько токенов с разными правами (например, один для чтения заказов, другой — для обновления цен).
Если вы серьёзно подходите к автоматизации, рекомендуется:
- Создавать отдельные токены для разных сервисов (чтобы при компрометации одного не пострадали остальные).
- Регулярно проверять активность токенов в личном кабинете (раздел API → Журнал запросов).
- Использовать имя токена только в доверенных сервисах (не передавать его случайным разработчикам).