Полный гайд по API Wildberries для работы с отзывами

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

API Wildberries — это программный интерфейс, который позволяет внешним сервисам взаимодействовать с вашим аккаунтом продавца на WB. Через API можно автоматизировать работу с товарами, заказами, ценами, рекламой и, конечно, отзывами. Для подключения сервиса автоответов на отзывы, такого как Отзывоматик, вам нужен API-токен с правами на раздел «Отзывы и вопросы».

WB API — это REST API, который работает через HTTP-запросы в формате JSON. Токен передаётся в заголовке Authorization каждого запроса. Все операции с отзывами выполняются через раздел API «Отзывы» (Feedbacks).

Как создать API токен Wildberries: пошаговая инструкция

Шаг 1: Войдите в WB Partners

Откройте seller.wildberries.ru и авторизуйтесь. Убедитесь, что вы вошли под аккаунтом с правами администратора — только администратор может создавать API-токены.

Шаг 2: Перейдите в раздел API

В левом меню найдите «Настройки» → «Доступ к API» (или «Токены API»). Здесь отображается список всех созданных токенов и их статус.

Шаг 3: Создайте новый токен

Нажмите «Создать новый токен». WB предложит выбрать название токена (для вашего удобства) и категории доступа. Для работы с отзывами выберите:

• «Отзывы и вопросы» (Feedbacks) — обязательно. Даёт право на чтение отзывов и отправку ответов.
• «Контент» (Content) — рекомендуется. Позволяет получать информацию о товарах для отображения рядом с отзывами.

Не выбирайте категории «Цены и скидки», «Заказы», «Финансы», «Реклама» — они не нужны для работы с отзывами и создают лишние риски безопасности.

Шаг 4: Сохраните токен

После создания WB покажет токен — длинную строку символов. Критически важно: токен показывается только один раз! Скопируйте его и сохраните в надёжном месте. Если потеряете — придётся создавать новый (старый при этом можно деактивировать).

Шаг 5: Подключите к Отзывоматик

Войдите в Отзывоматик → «Настройки» → раздел «Wildberries» → вставьте API Key → «Сохранить». Система проверит токен и начнёт синхронизацию отзывов.

Основные эндпоинты API для работы с отзывами

WB API для отзывов предоставляет несколько ключевых эндпоинтов:

Получение списка отзывов

GET /api/v1/feedbacks — возвращает список отзывов с возможностью фильтрации по дате, рейтингу, статусу ответа. Поддерживает пагинацию для обработки большого количества отзывов.

Параметры фильтрации: isAnswered (есть ли ответ), dateFrom/dateTo (период), order (сортировка), take/skip (пагинация).

Получение деталей отзыва

GET /api/v1/feedbacks/{id} — возвращает полную информацию об отзыве: текст, рейтинг, фото покупателя, дата, информация о товаре.

Отправка ответа на отзыв

POST /api/v1/feedbacks/{id}/reply — отправляет ответ продавца на конкретный отзыв. Тело запроса содержит текст ответа. После отправки ответ проходит модерацию WB.

Получение количества неотвеченных отзывов

GET /api/v1/feedbacks/count — быстрый способ узнать, сколько отзывов ожидают ответа, без загрузки полного списка.

Лимиты API Wildberries

WB устанавливает ограничения на количество запросов для защиты от злоупотреблений:

• Общий лимит: до 100 запросов в минуту для большинства эндпоинтов
• Отправка ответов: до 30 ответов в минуту
• Пагинация: максимум 1000 записей за один запрос
• Таймаут: запрос должен выполниться за 30 секунд, иначе будет прерван

При превышении лимитов API возвращает ошибку 429 (Too Many Requests). Отзывоматик автоматически контролирует частоту запросов и использует экспоненциальный backoff при приближении к лимитам.

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

API-токен — это ключ к вашему магазину. Правила безопасности:

• Принцип минимальных привилегий — создавайте токен только с теми правами, которые реально нужны. Для отзывов не нужен доступ к финансам.
• Один токен — один сервис — для каждого внешнего сервиса создавайте отдельный токен. Если один скомпрометирован, деактивируете только его.
• Не публикуйте токен — не отправляйте в открытых чатах, не храните в незашифрованных файлах, не коммитьте в Git.
• Регулярная ротация — меняйте токены раз в 3-6 месяцев. Деактивируйте старый после создания нового.
• Мониторинг — если заметили подозрительную активность (ответы, которые вы не отправляли), немедленно деактивируйте токен.

Отзывоматик хранит токены в зашифрованном виде (AES-256) и никогда не передаёт их третьим лицам.

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

• 401 Unauthorized — неверный или деактивированный токен. Проверьте, что копируете токен без пробелов.
• 403 Forbidden — у токена нет прав на запрошенный ресурс. Создайте новый токен с нужными категориями.
• 429 Too Many Requests — превышен лимит запросов. Подождите минуту и повторите.
• Пустой список отзывов — убедитесь, что фильтры корректны. Попробуйте запрос без фильтров для проверки.
• Ответ не отправляется — проверьте, что текст ответа не пустой и не превышает лимит символов (обычно 1000 символов).

Попробуйте Отзывоматик бесплатно — подключите WB API за 5 минут и автоматизируйте ответы на отзывы. 299 ₽/мес за все маркетплейсы. Начать бесплатно