WB API — программный интерфейс Wildberries. Большинство действий, которые продавец выполняет в личном кабинете WB Партнёры, доступны и через HTTP-методы API.
Для стороннего сервиса — например, учётной системы, аналитической платформы или инструмента автоматизации — WB API позволяет работать с данными и выполнять действия от имени подключённых продавцов. Интеграция пишется один раз и обслуживает любое число магазинов: под каждого нового продавца сервис принимает доступ, а не разрабатывает отдельное подключение.
В этой статье разберём:
У сервиса нет собственного доступа к данным продавца на Wildberries. Доступ предоставляет сам продавец в личном кабинете WB Партнёры (seller.wildberries.by): через токен или через упрощённое подключение по OAuth 2.0.
При создании токена или подключении сервиса продавец определяет границы доступа сторонней системы к своим данным:
Токен передаётся в заголовке Authorization каждого запроса. Запросы выполняются по HTTPS, данные передаются в формате JSON.
Для каждого подключённого продавца используется его собственный токен. Данные одного магазина недоступны по токену другого продавца.
Какие есть методы, к каким категориям данных они относятся и на каком хосте работают — в документации WB API.
Токен — ключ к данным бизнеса продавца. Он принадлежит продавцу, а сервис отвечает за его безопасное хранение и использование. Подробнее о видах токенов, сроках их действия и правилах работы с ними, а также о подключении по OAuth 2.0 — в статье «Доступ к данным продавца: токены и OAuth 2.0».
Методы 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) работает на серверах поставщика и обслуживает нескольких продавцов. Продавцы регистрируются в интерфейсе сервиса и подключают к нему свои магазины.
Так как данные обрабатываются на стороне сервиса, для облачных решений действуют отдельные правила. Облачный сервис:
Персональные токены предназначены для решений, работающих в инфраструктуре продавца, и могут давать расширенный доступ, включая чувствительные данные.
Если решение позиционируется как коробочное, но данные фактически обрабатываются на серверах сервиса — для платформы это облачный сервис со всеми его правилами.
| Признак | Коробочное решение | Облачный сервис |
|---|---|---|
| Где работает | В инфраструктуре продавца | На серверах поставщика сервиса |
| Сколько продавцов обслуживает копия | Одного | Многих |
| Токен продавца | Персональный | Базовый; в Каталоге решений — Сервисный |
| Подключение по 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.