Ключ Wildberries: как создать и куда вставить

Зачем сервису ключ

Ключ — это разрешение работать с вашими карточками от вашего имени. Без него мы видим только те фото, которые вы загрузили руками; с ним подтягиваем товары из магазина и умеем отправлять готовые фото обратно.

• Читаем: список карточек, названия, описания, артикулы, фото.
• Пишем: только то, что вы сами отправили кнопкой — фото и текст карточки.
• Не запрашиваем вообще: деньги, заказы, поставки, рекламу, отзывы.

Последний пункт — не обещание на словах. Мы просим у площадки доступ только к одной категории, «Контент». Остальное физически недоступно по такому ключу, даже если бы мы захотили.

Что понадобится

Вход в кабинет Wildberries под владельцем магазина. У сотрудника с ограниченными правами раздела с токенами обычно нет — если вы его не находите, скорее всего дело в этом.

Шаги

1. Откройте кабинет продавца Wildberries и нажмите на название магазина в правом верхнем углу.
2. Выберите Настройки, внутри — Доступ к API. В некоторых кабинетах раздел называется «Интеграции» или просто «API» — ищите по слову API.
3. Нажмите Создать новый токен.
4. Придумайте имя — например, «ФокусМП». Имя видно только вам и нужно, чтобы потом понимать, какой токен куда выдан.
5. Отметьте категорию Контент. Больше ничего отмечать не нужно.
6. Галочку «Только на чтение» не ставьте — иначе товары мы увидим, а выгрузить готовое фото обратно не сможем.
7. Галочку «Тестовый контур» тоже не ставьте — это песочница, настоящих товаров там нет.
8. Нажмите Создать токен и сразу скопируйте длинную строку целиком. Площадка показывает её один раз.
9. Вернитесь сюда, в «Кабинет продавца» → «Синхронизация», вставьте ключ и нажмите Подключить и проверить.

Срок действия

У токена есть срок годности — дата видна на странице создания в кабинете Wildberries, а после подключения мы показываем её и у себя, рядом с ключом. Когда срок закончится, синхронизация перестанет работать: выпустите новый токен тем же способом и вставьте его в поле «Заменить ключ». Ничего из уже сделанного при этом не теряется.

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

Ключ — это как пароль от витрины магазина: по нему можно менять ваши карточки. Относитесь к нему соответственно.

• Не пересылайте его в мессенджерах и не выкладывайте в общие документы.
• У нас он хранится и показывается только частично — ни в интерфейсе, ни в письмах он целиком не появляется.
• Если ключ куда-то утёк, удалите его в кабинете Wildberries — доступ пропадёт сразу, обращаться в поддержку площадки не нужно. Потом выпустите новый и замените у нас.

Если не получилось

«Это не похоже на ключ»

В строку попал пробел, перенос строки или русские буквы. Обычно так бывает, когда ключ копируют не целиком. Скопируйте ещё раз полностью — это длинная строка из латиницы, цифр и точек.

«Wildberries не принял этот ключ»

Площадка ответила отказом. Три частые причины: у токена нет категории «Контент», токен просрочен, или он от другого магазина.

Ключ принят, но товаров не нашлось

Проверьте, что в магазине есть карточки не в черновиках, и что у токена отмечен «Контент». Карточки из черновиков площадка по API не отдаёт.

Раздела с токенами нет в кабинете

Вы зашли не под владельцем магазина. Токены создаёт только владелец аккаунта.

Не помогло — напишите в поддержку, приложите текст ошибки. Ключ присылать не нужно, он нам для разбора не требуется.