API Wildberries: документация

API Wildberries нужен всем, кто хочет автоматизировать работу на маркетплейсе: обновлять цены, отгружать товар, тянуть заказы и статистику без ручного клика. Дальше разберём, где взять API ключ вайлдберриз, как устроена wildberries api документация и почему токенов на самом деле несколько.

TL;DR: короткий ответ

API ключ Wildberries генерируется в личном кабинете продавца: раздел «Настройки» — «Доступ к API». Ключ бывает разных категорий (Контент, Цены, Маркетплейс, Статистика, Аналитика, Продвижение и другие) и привязан к вашему юрлицу. Полная wildberries api документация лежит на портале для разработчиков и разбита по этим же категориям.

Что такое API Wildberries и зачем он бизнесу

API это программный интерфейс. Через него ваши скрипты, сервисы учёта и ERP общаются с маркетплейсом напрямую, минуя браузер и ручной труд.

Продавец на паре карточек проживёт и без API. Как только товаров становятся сотни, а заказы идут потоком, ручное управление превращается в узкое место. Тут и подключают автоматизацию.

Через API решают конкретные задачи. Массово меняют цены и скидки. Автоматически подтягивают новые заказы в свою систему. Обновляют остатки на складах. Тянут статистику продаж для отчётов и аналитики.

Отдельная история: wildberries api покупателя. Это набор методов, которые отдают данные о заказах и поведении со стороны клиента маркетплейса: отзывы, вопросы, статусы. Продавцу это нужно, чтобы вовремя отвечать и не терять рейтинг.

Где взять API ключ вайлдберриз: пошагово

Вопрос, где взять api ключ вайлдберриз, звучит чаще всего. Разберём по шагам, без лишних слов.

1. Зайдите в личный кабинет продавца на seller.wildberries.ru под своим аккаунтом.
2. Откройте профиль в правом верхнем углу и найдите пункт «Настройки».
3. Перейдите в раздел «Доступ к API». Иногда он называется «Настройки — API».
4. Нажмите «Создать новый токен».
5. Задайте имя токена. Назовите его по смыслу: например, «Цены-ERP» или «Статистика-отчёты».
6. Выберите категории доступа. Отмечайте только те, что реально нужны.
7. Решите, нужен ли режим «только на чтение». Для аналитики без записи это безопаснее.
8. Нажмите «Создать токен» и сразу скопируйте его.

Важный момент: ключ показывается один раз. После закрытия окна вы его больше не увидите. Потеряли токен: не восстановите, только выпустите новый. Сохраните его в надёжное место, лучше в менеджер секретов, а не в заметки.

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

Кто может создавать токены

По умолчанию токен генерирует владелец аккаунта. Если вы работаете с сотрудниками, доступ к разделу API нужно выдать через управление правами. Не давайте полный доступ подрядчику: выпустите отдельный токен с ограниченным набором категорий и при необходимости отзовите его.

Категории токенов: почему ключ не один

Главная путаница новичков: они думают, что API ключ вайлдберриз один на всё. Это не так. Wildberries разделил доступ по категориям, и каждый токен работает только со своими методами.

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

Один токен может совмещать несколько категорий: их отмечают галочками при создании. Но опытные продавцы дробят доступ. Отдельный ключ на цены, отдельный на статистику. Так проще отозвать один, не сломав всю интеграцию.

Как устроена wildberries api документация

Официальная wildberries api документация живёт на портале для разработчиков. Структура повторяет категории токенов: у каждой свой раздел с методами, адресами и примерами запросов.

Документация разбита на группы. Контент. Цены и скидки. Маркетплейс. Статистика. Аналитика. Продвижение. Отзывы и вопросы. Внутри каждой группы описаны эндпоинты: адрес, метод HTTP, параметры, формат ответа.

У разных категорий разные базовые адреса. Например, методы статистики и методы контента живут на разных доменах-хостах. Это частая причина ошибок: скопировали адрес из соседнего раздела и получили 404. Всегда сверяйте базовый URL с нужной категорией.

Ещё в документации есть Swagger. Это интерактивная страница, где можно посмотреть точную схему запроса и ответа, а иногда и выполнить пробный вызов. Для разработчика это быстрее, чем читать текст.

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

На каждый метод в документации смотрят по одной схеме. Сначала тип запроса: GET для чтения, POST для изменения. Потом адрес эндпоинта. Дальше обязательные и необязательные параметры. В конце пример ответа с полями.

Авторизация везде одинаковая: токен передаётся в заголовке Authorization. Без него любой запрос вернёт ошибку 401. Это первое, что проверяют при отладке.

Wildberries api покупателя: что это и чем полезно

Термин wildberries api покупателя используют в двух смыслах, и их важно не путать.

Первый смысл: методы, которые отдают продавцу данные со стороны покупателя. Отзывы, вопросы, оценки, статусы заказов клиента. Эти методы входят в категории «Вопросы и отзывы» и частично «Статистика». Продавец через них видит, что пишут о товаре, и отвечает.

Второй смысл: публичные данные карточек, которые видит любой покупатель на витрине. Цена, наличие, характеристики, отзывы. Часть таких данных доступна без авторизации через публичные адреса витрины. Но это не официальный раздел для продавцов, и стабильность таких вызовов Wildberries не гарантирует.

Для бизнеса полезнее первый смысл. Через wildberries api покупателя вы автоматизируете работу с обратной связью: собираете все новые отзывы, фильтруете негатив, отвечаете шаблонами или через нейросеть. Быстрый ответ на вопрос повышает конверсию карточки, а реакция на отзыв держит рейтинг.

Лимиты, безопасность и сроки жизни токена

API Wildberries работает с ограничениями. Их надо учитывать, иначе интеграция будет упираться в блокировки.

Есть лимиты частоты запросов. У каждой группы методов свой порог: сколько вызовов в минуту разрешено. Превысили: получаете ответ 429 «слишком много запросов». Правильное решение: ставить паузы и повторять запрос с задержкой, а не долбить эндпоинт в цикле.

Токен имеет срок жизни. Wildberries периодически меняет правила, поэтому держите под рукой процедуру перевыпуска. Если интеграция вдруг отдаёт 401, первым делом проверяйте, не истёк ли ключ.

Безопасность ключа это ваша ответственность. Несколько правил, которые экономят нервы.

• Не храните токен в коде и в репозитории. Только в переменных окружения или менеджере секретов.
• Не передавайте один ключ нескольким подрядчикам. Выпустите отдельный на каждого.
• Давайте минимум категорий. Нужна статистика: не добавляйте доступ к ценам.
• Используйте режим «только чтение» там, где запись не нужна.
• Отзывайте старые токены сразу, как только интеграция сменилась.

Частые ошибки при работе с API

Собрали типичные грабли, на которые наступают продавцы и разработчики.

• Ждут один ключ на всё. API ключ вайлдберриз разделён по категориям. Метод из «Цен» не сработает с токеном «Статистики».
• Путают базовые адреса. У разных категорий разные хосты. Скопировали URL из чужого раздела: ловите 404.
• Забывают заголовок Authorization. Без токена в заголовке любой запрос отдаёт 401.
• Игнорируют лимиты. Запросы в бесконечном цикле без пауз приводят к 429 и временной блокировке.
• Теряют токен. Ключ показывается один раз. Не сохранили: только перевыпуск.
• Дают полный доступ подрядчику. Утечёт такой ключ: злоумышленник сможет менять цены и жечь рекламный бюджет.
• Не обрабатывают ошибки. API может вернуть пустой ответ или частичные данные. Скрипт без проверки молча запишет мусор.
• Берут неофициальные адреса витрины. Работают до первого изменения на стороне Wildberries, потом ломаются без предупреждения.

Как выбрать: свой скрипт или готовый сервис

Не всем нужно программировать. Разберём, когда писать код, а когда взять готовое решение.

Логика простая. Товаров немного и задачи стандартные: берите готовый сервис учёта с поддержкой Wildberries. Крупный оборот, свои правила ценообразования, интеграция с ERP: пишите под себя или заказывайте разработку.

Промежуточный вариант: связка no-code инструментов с API через готовые коннекторы. Подходит, когда хочется автоматизации без штатного программиста.

Чек-лист перед подключением API

Пройдитесь по списку, прежде чем запускать интеграцию в бой.

1. Определили, какие задачи автоматизируете: цены, заказы, статистика, отзывы.
2. Выбрали нужные категории токенов под эти задачи.
3. Создали токен с минимальным набором прав.
4. Сохранили ключ в менеджер секретов, не в код.
5. Сверили базовые адреса методов с wildberries api документация.
6. Заложили обработку ошибок 401, 429 и пустых ответов.
7. Настроили паузы между запросами под лимиты.
8. Проверили интеграцию на тестовых данных перед массовым запуском.

Частые вопросы

Где взять API ключ вайлдберриз, если раздела нет в кабинете

Раздел «Доступ к API» появляется в «Настройках» личного кабинета продавца. Если вы его не видите, скорее всего вошли под сотрудником без прав. Попросите владельца аккаунта выдать доступ к управлению API или создать токен самостоятельно и передать его вам защищённым способом.

Сколько токенов можно создать

Wildberries позволяет держать несколько токенов одновременно, разделяя их по категориям и задачам. Практика: отдельный ключ на каждую интеграцию или подрядчика. Так проще отозвать один токен, не ломая остальные процессы. Точное число активных ключей уточняйте в актуальной документации.

Что такое wildberries api покупателя простыми словами

Это методы, которые дают продавцу данные со стороны клиента: отзывы, вопросы, оценки, статусы заказов. Через них автоматизируют работу с обратной связью: собирают новые отзывы, отвечают быстро, следят за рейтингом. Часть данных витрины доступна публично, но официальной поддержки для таких вызовов нет.

Почему запросы возвращают ошибку 401

Код 401 значит проблему с авторизацией. Причины три: не передали токен в заголовке Authorization, токен истёк или отозван, ключ не той категории для этого метода. Проверьте по порядку: заголовок, срок жизни ключа, соответствие категории методу из wildberries api документация.

Нужен ли программист, чтобы пользоваться API

Не обязательно. Для типовых задач хватает готовых сервисов учёта: подключаете токен через интерфейс и работаете без кода. Программист нужен, когда логика нестандартная, оборот большой или требуется интеграция с вашей ERP. Тогда пишут собственное решение под конкретные процессы.