Как создать, обновить или удалить токен WB API

Пошаговые инструкции для каждого типа токена

content

Важные правила

Перед созданием токена ознакомьтесь с ключевыми моментами:

  • Создавать и удалять токены может только владелец личного кабинета
  • Срок действия токена — 180 дней. За 3 дня до истечения срока владельцу придёт уведомление в «колокольчик» в правом верхнем углу личного кабинета продавца
  • Токен показывается только один раз при создании — сразу сохраните его в надёжном месте
  • При смене владельца все токены перестают работать — новому владельцу нужно создать их заново
  • Можно создать до 20 активных токенов на один магазин

Подробнее о безопасном хранении и работе с токенами — в статье «Безопасность данных продавца при работе с WB API»


Какой тип токена создать?

Выберите раздел инструкции в зависимости от вашей задачи:

ЗадачаКакой токен создать
Подключаю сервис из Каталога решенийСервисный (или OAuth 2.0)
Подключаю свою программу или on-premise системуПерсональный
Другие случаиБазовый
Тестирование в песочницеТестовый

Подробнее о различиях между типами и когда какой выбрать — в статье «Способы подключения к WB API». Если не уверены, облачная у вас программа или локальная — в статье «Облачный сервис или локальное решение»


Как начать создание токена

Прежде чем создавать токен любого типа, выполните следующие шаги:

  1. В личном кабинете WB Партнёры откройте окно профиля, нажав на название вашей организации в правом верхнем углу экрана
  2. Выберите в меню профиля раздел Интеграции по API
  3. Нажмите «+ Создать токен»

Откроется окно создания токена с двумя вкладками: «Для сервиса из каталога» и «Для интеграции вручную».

Дальнейшие действия зависят от типа токена — выберите соответствующий раздел инструкции ниже.


Как создать Сервисный токен

Сервисный токен используется для подключения конкретного облачного сервиса из официального Каталога решений для бизнеса на Wildberries.

Когда использовать: если вы подключаете готовый облачный сервис, который есть в Каталоге.


Как создать Персональный токен

Персональный токен предназначен для предоставления доступа к данным продавца вашим собственным программам или готовым корпоративным системам в редакции on-premise, развёрнутым на вашей инфраструктуре.

Когда использовать: если вы подключаете собственную программу или готовую систему (например, локальную версию 1С, ERP, CRM) на ваших серверах или компьютерах.


Как создать Базовый токен

Базовый токен предоставляет доступ к ограниченному списку категорий данных и используется, когда не подходят Сервисный или Персональный токены.

Когда использовать: для тестирования интеграции на реальных данных или в других случаях, когда другие типы токенов не подходят.


Как создать Тестовый токен

Тестовый токен предназначен для безопасного тестирования и отладки интеграций в песочнице — изолированной среде с тестовыми данными.

Когда использовать: для разработки и тестирования без риска для реальных данных магазина.

Подробнее — в статье «Тестовый токен и Песочница WB API»


Как удалить токен

Если есть подозрение, что токен скомпрометирован, немедленно удалите его:

  1. Откройте окно профиля на портале и выберите Интеграции по API
  2. Найдите нужный токен в списке и нажмите «Удалить»
  3. Подтвердите удаление
  4. Создайте новый токен и обновите его в настройках системы

При подозрении на несанкционированный доступ создайте сообщение в поддержке продавцов Wildberries, категория «Безопасность личного кабинета», тема «Несанкционированный вход».


Как обновить токен

Токены действуют 180 дней, после чего перестают работать. За 3 дня до завершения срока владельцу придёт уведомление.

Рекомендуемый план действий

Начинайте обновление за 7–14 дней до завершения срока действия:

  1. Откройте раздел Интеграции по API в окне профиля
  2. Найдите токен, который нужно обновить
  3. Нажмите кнопку «Дублировать» — откроется окно создания токена с такими же настройками. Подтвердите создание и скопируйте новый токен
  4. Замените старый токен на новый во всех системах, где он используется
  5. Проверьте работоспособность интеграции с новым токеном в течение нескольких дней
  6. Удалите старый токен только после того, как убедитесь, что новый работает корректно

Совет: настройте напоминание в календаре за 2 недели до истечения срока действия токена.


Часто задаваемые вопросы