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

API Wildberries позволяет сторонним сервисам получать данные вашего магазина: товары, заказы, остатки, финансовые отчёты. Это основа для работы аналитических сервисов. Разберём, как создать API-ключ и безопасно подключить его.

Что такое API Wildberries

API (Application Programming Interface) — это способ для программ обмениваться данными. API Wildberries позволяет получать данные вашего магазина в структурированном виде, без ручного скачивания отчётов.

Через API можно получить:

• Список товаров и карточек
• Заказы и продажи
• Остатки на складах
• Финансовые отчёты
• Цены и скидки
• Статистику рекламных кампаний

Шаг 1: Войдите в личный кабинет WB

Перейдите в личный кабинет продавца Wildberries. Убедитесь, что вы вошли под аккаунтом владельца магазина или имеете права администратора.

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

Найдите раздел управления API-ключами. Путь: Настройки (иконка шестерёнки) -> Доступ к API.

Здесь вы увидите список уже созданных ключей (если они есть) и кнопку создания нового.

Шаг 3: Создайте новый API-ключ

Нажмите «Создать ключ». WB предложит выбрать категории данных, к которым ключ будет иметь доступ.

Категории доступа

| Категория | Что даёт | Нужно ли | |-----------|----------|----------| | Контент | Карточки товаров, описания, фото | Да | | Аналитика | Статистика продаж, заказов | Да | | Цены и скидки | Текущие цены, акции | Да | | Маркетплейс | Заказы, поставки, склад | Да | | Статистика | Финансовые отчёты, детализация | Да | | Реклама | Рекламные кампании | По желанию | | Рекомендации | Рекомендуемые цены | По желанию | | Вопросы и отзывы | Отзывы покупателей | По желанию |

Для аналитики продаж выберите минимум: Контент, Аналитика, Цены и скидки, Маркетплейс, Статистика.

Важно: только чтение

Все перечисленные категории дают доступ только на чтение данных. API-ключ с этими правами не может:

• Изменять цены
• Редактировать карточки товаров
• Создавать или отменять заказы
• Удалять товары
• Делать любые другие действия от вашего имени

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

Шаг 4: Скопируйте ключ

После создания WB покажет ваш API-ключ. Скопируйте его и сохраните в надёжном месте.

Ключ показывается только один раз. Если потеряете — придётся создавать новый.

Формат ключа: длинная строка символов вида eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...

Шаг 5: Подключите к HubMarket

1. Зарегистрируйтесь на HubMarket (если ещё нет)
2. Перейдите в Настройки -> Магазины
3. Нажмите «Добавить магазин»
4. Выберите Wildberries
5. Вставьте API-ключ
6. Дайте магазину название (например, «Мой магазин WB»)
7. Нажмите «Подключить»

HubMarket проверит ключ и начнёт загружать данные. Первая синхронизация занимает от 1 до 10 минут, в зависимости от объёма данных.

Безопасность API-ключей

Как HubMarket защищает ваши данные

• Шифрование AES-256-GCM — ключи хранятся в зашифрованном виде. Даже при утечке базы данных ключи невозможно прочитать
• Только чтение — мы используем только права на получение данных
• Нет передачи третьим лицам — ваши данные не продаются и не передаются
• HTTPS — все соединения зашифрованы

Общие правила безопасности

• Не передавайте API-ключ по открытым каналам (мессенджеры, email)
• Создавайте отдельные ключи для разных сервисов
• Регулярно проверяйте список активных ключей в ЛК WB
• Если подозреваете утечку — деактивируйте ключ и создайте новый

Несколько магазинов

Если у вас несколько магазинов на Wildberries, создайте API-ключ для каждого и добавьте их отдельно в HubMarket. Вы сможете переключаться между магазинами и видеть аналитику по каждому.

Что делать, если ключ не работает

Ошибка 401 (Unauthorized)

Ключ недействителен. Причины:

• Ключ деактивирован в ЛК WB
• Скопировали не полностью (обрезалось начало или конец)
• Ключ создан без нужных категорий доступа

Решение: создайте новый ключ с правильными категориями.

Ошибка 403 (Forbidden)

Ключ действителен, но не имеет прав на запрашиваемые данные.

Решение: проверьте, что при создании ключа вы выбрали все необходимые категории.

Данные не загружаются

Первая синхронизация может занять до 10 минут. Если данных нет через 30 минут:

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

Что дальше

После подключения API-ключа HubMarket автоматически загрузит:

• Все ваши товары с карточками
• Историю заказов и продаж
• Текущие остатки на складах
• Цены и скидки
• Финансовые данные

Укажите себестоимость товаров — и сервис рассчитает юнит-экономику, маржинальность и P&L автоматически.

Зарегистрируйтесь на HubMarket бесплатно и подключите свой магазин за 2 минуты.