• Документация
  • Журнал изменений
  • Песочница
  • База знаний
  • Документация
  • Журнал изменений
  • Песочница
  • База знаний
  • Документация
  • Журнал изменений
  • Песочница
  • База знаний

©Wildberries 2004–2026. Все права защищены.

Политика обработки персональных данныхПолитика в отношении cookies

WB API для сервисов

Что платформа даёт стороннему сервису, чем облачный сервис отличается от коробочного и как пройти путь от первого запроса до Каталога решений

0
content

WB API — программный интерфейс Wildberries. Большинство действий, которые продавец выполняет в личном кабинете WB Партнёры, доступны и через HTTP-методы API.

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

В этой статье разберём:

  • как сервис получает доступ к данным продавца;
  • чем облачные сервисы отличаются от коробочных решений;
  • с какими данными сервис может работать через WB API;
  • какие есть варианты работы сервиса с платформой;
  • с чего начать разработку и подключение.

Как сервис получает доступ к данным продавца

У сервиса нет собственного доступа к данным продавца на Wildberries. Доступ предоставляет сам продавец в личном кабинете WB Партнёры (seller.wildberries.by): через токен или через упрощённое подключение по OAuth 2.0.

При создании токена или подключении сервиса продавец определяет границы доступа сторонней системы к своим данным:

  • Категории данных — разделы данных, к которым сервис получает доступ: товары, заказы, цены, аналитика и другие.
  • Уровень доступа — «Только чтение» или «Чтение и запись». Определяет, может ли сервис только получать данные или ещё и менять их.
  • Тип токена — задаётся только при выдаче доступа через токен. Определяет, какие методы доступны и какие лимиты применяются к запросам.

Токен передаётся в заголовке Authorization каждого запроса. Запросы выполняются по HTTPS, данные передаются в формате JSON.

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

Какие есть методы, к каким категориям данных они относятся и на каком хосте работают — в документации WB API.

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


С какими данными сервис может работать через WB API

Методы WB API сгруппированы по функциональным областям. В каждой из них сервис может читать данные или выполнять действия от имени продавца — в пределах доступа, который задал продавец.

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

Раздел документацииЧто сервис получает и делает
ОбщееСлужебные методы: авторизация, проверка подключения, информация о продавце, управление пользователями кабинета, новости платформы через News API
Работа с товарамиКарточки товаров и медиафайлы, цены и скидки, склады продавца и остатки
Заказы FBSЗаказы, которые продавец собирает и отгружает со своего склада: сборочные задания, этикетки, отгрузка
DBSСборочные задания, доставка, обновление статусов и идентификаторы маркировки
СамовывозСборочные задания, обновление статусов и идентификаторы маркировки
Поставки FBWПоставки, данные складов и статусы
Маркетинг и продвижениеРекламные кампании WB Продвижение: запуск, ставки, финансовые данные и статистика; календарь акций
Общение с покупателямиВопросы и отзывы, чаты с покупателями, возвраты
ТарифыКомиссии и тарифы Wildberries — данные для расчёта экономики продавца
Аналитика и данныеВоронка продаж, поисковые запросы по товарам, история остатков
ОтчётыОтчёты по товарам и удержаниям
Документы и бухгалтерияБаланс продавца, финансовые отчёты и документы

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

Например, для аналитики, отчётности и учёта обычно достаточно уровня доступа «Только чтение». Для управления карточками, ценами, заказами и продвижением нужен уровень «Чтение и запись».

Чем меньше категорий данных сервис запрашивает у продавца, тем понятнее назначение доступа и тем ниже риск при компрометации токена.

Лимиты запросов

У каждого метода WB API есть лимит запросов. Лимиты считаются на аккаунт продавца, а величина задаётся для отдельного метода или для группы методов — внутри одной категории данных значения различаются. Размер лимита зависит и от типа токена.

Точные значения — в описании конкретного метода в документации. Подробнее о механике лимитов и поведении при их превышении — в статье «Идентификация сервиса в WB API».

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


Коробочные и облачные сервисы

Платформа различает сервисы по тому, где работает программа и кто управляет её инфраструктурой. От этого зависит, какие токены может использовать решение, может ли оно подключать продавцов по OAuth 2.0 и требуется ли ему регистрация на платформе.

Коробочное (локальное) решение

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

Такое решение нельзя подключить через OAuth 2.0. Оно подключается с помощью Персонального токена: продавец самостоятельно создаёт его и добавляет в настройках своей копии программы. Регистрация на платформе и сервисный секрет здесь не нужны — с точки зрения WB API запросы делает сам продавец.

Облачный сервис (SaaS)

Облачный сервис (SaaS) работает на серверах поставщика и обслуживает нескольких продавцов. Продавцы регистрируются в интерфейсе сервиса и подключают к нему свои магазины.

Так как данные обрабатываются на стороне сервиса, для облачных решений действуют отдельные правила. Облачный сервис:

  • принимает от продавцов Базовые токены;
  • после публикации в Каталоге решений для бизнеса на Wildberries может работать с Сервисными токенами;
  • не должен принимать Персональные токены.

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

Если решение позиционируется как коробочное, но данные фактически обрабатываются на серверах сервиса — для платформы это облачный сервис со всеми его правилами.

ПризнакКоробочное решениеОблачный сервис
Где работаетВ инфраструктуре продавцаНа серверах поставщика сервиса
Сколько продавцов обслуживает копияОдногоМногих
Токен продавцаПерсональныйБазовый; в Каталоге решений — Сервисный
Подключение по OAuth 2.0НедоступноДоступно после публикации в Каталоге решений
Регистрация и сервисный секретНе нужныНужны по мере роста — см. варианты ниже

Подробнее о типах токенов и способах их передачи сервису — в статье «Доступ к данным продавца: токены и OAuth 2.0».


Варианты работы облачного сервиса с платформой

Облачный сервис выстраивает отношения с платформой поэтапно: начать можно без формальностей, а подниматься по уровням — по мере роста клиентской базы.

ВариантКак получитьЧто даёт
Разработка и тестированиеНичего не нужно: продавец создаёт Базовый токен и передаёт сервисуБыстрый старт: большинство методов WB API доступно уже на этом уровне — достаточно, чтобы собрать интеграцию и проверить её на первых продавцах
Зарегистрированный сервисПисьмо на business-solutions@rwb.ru с описанием сервиса и задачиСервисный секрет (ключ доступа), которым сервис помечает свои запросы: платформа идентифицирует его трафик и применяет расширенные лимиты
Сервис в Каталоге решенийЗаявка тоже через business-solutions@rwb.ru — когда сервис готов к массовой аудиторииВсё то же, что даёт регистрация, включая расширенные лимиты, а сверх того: витрина для продавцов, Сервисный токен с собственными лимитами, не зависящими от других интеграций продавца, автозаполнение настроек токена при подключении, подключение продавцов по OAuth 2.0, доступ к методам с дополнительными требованиями и право упоминать присутствие в Каталоге в собственных маркетинговых коммуникациях

Уровни — этапы одного пути, а не альтернативы. Работа без регистрации — стадия разработки и тестирования, а не постоянный режим: облачный сервис, у которого появились клиенты, обозначает себя на платформе.

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

Каталог решений — витрина проверенных сервисов, в которой продавцы ищут инструменты для своих задач. Для сервиса это канал привлечения клиентов и статус: продавец видит, что сервис прошёл проверку Wildberries. Подключение из Каталога решений короче: настройки токена заполняются для продавца автоматически, а сервису доступно подключение продавцов через OAuth 2.0 — без ручной передачи токена. Оба способа разобраны в статье «Доступ к данным продавца: токены и OAuth 2.0», документацию по OAuth 2.0 команда платформы высылает по запросу.

Получение секрета, правила разметки трафика и работа с лимитами — в статье «Идентификация сервиса в WB API».


С чего начать

Изучите документацию

Начните с раздела «Общее» — там авторизация и служебные методы, — затем переходите к разделам под функцию сервиса. Выполнить запрос без кода можно в Swagger. За изменениями API следите в Release Notes.

Кроме методов, сервису нужны ещё две темы. Как продавец передаёт доступ — статья «Доступ к данным продавца: токены и OAuth 2.0». Как платформа опознаёт запросы сервиса и считает лимиты — статья «Идентификация сервиса в WB API».

Сделайте первый запрос

Для пилота подойдёт Базовый токен продавца. Методы проверки подключения из раздела «Общее» помогут убедиться, что запрос собран правильно и токен работает.

Зарегистрируйте сервис и добавьте его в Каталог

Когда появились первые клиенты, напишите на business-solutions@rwb.ru: опишите сервис и задачу, которую он решает для продавцов. Регистрация даст сервисный секрет и откроет путь в Каталог решений. Если сервис уже соответствует требованиям Каталога, в том же письме можно подать заявку сразу на размещение.

Регистрация сервиса, получение сервисного секрета, заявка в Каталог решений и запрос документации по OAuth 2.0 проходят через один адрес: business-solutions@rwb.ru.


Что дальше

  • Токены, OAuth 2.0 и правила работы с ними → статья «Доступ к данным продавца: токены и OAuth 2.0»
  • Сервисный секрет, лимиты запросов и User-Agent → статья «Идентификация сервиса в WB API»
  • Методы, схемы запросов и коды ответов → документация WB API
  • Изменения в методах → Release Notes

Кейсы

Найдите решение по другим вопросам
WB API case
Доступ к данным продавца: токены и OAuth 2.0
WB API case
Идентификация сервиса в WB API
WB API case
Карта вызовов WB API