Каталог решений - Вводный сабж в WB API

Если вы уже знакомы с документацией API Ozon, Yandex и др., то, возможно, и API Wildberries (WB) у вас не вызовет затруднений. Не ставлю себе цель описывать очевидные вещи, но конкретно к этому сабжу подтолкнуло несколько комментариев в телеграмме по поводу сложности восприятия справки WB и обработки запросов в 1С. Постарался максимально кратко показать основные моменты, которые помогут быстро разобраться с документацией и понять принцип построения запросов на этой платформе.

Основные моменты:
1. Ссылки на документацию:

• Старая документация: https://openapi.wildberries.ru/
• Новая документация: https://dev.wildberries.ru/

2. Категории запросов:

Все API-методы выделены в категории. Каждая категория имеет свой домен третьего уровня.

Например:

• Отчеты:  statistics-api.wildberries.ru
• Аналитика продавца:  advert-api.wildberries.ru
• Заказы FBS:  marketplace-api.wildberries.ru

3. Тестовый и рабочий контуры:

• Рабочий контур:

Рабочий контур предоставляет широкие возможности взаимодействия с реальными данными в рамках API. При необходимости тут можно использовать отдельные токены "только на чтение".

• Тестовый контур:

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

• Разница между Рабочим и Тестовым контуром:

Главное различие между песочницей и рабочим контуром — это адрес сервера.

   — Рабочий контур: *-api.wildberries.ru
   — Тестовый контур: *-api-sandbox.wildberries.ru

В документации тестовые запросы выделены в отдельную группу "Песочница", хотя по факту используют те же самые методы, что и рабочие запросы. К сожалению количество методов в песочнице меньше чем в рабочем контуре. Полный их список можно найти здесь: https://dev.wildberries.ru/sandbox

• Примеры запросов:

    — Рабочий запрос: https://statistics-api.wildberries.ru/api/v1/supplier/stocks?dateFrom=2020-12-01
      (Примечание: этот запрос создаст выборку за любой период указанный в параметре dateFrom)

    — Тестовый запрос: https://statistics-api-sandbox.wildberries.ru/api/v1/supplier/stocks?dateFrom=2024-12-01
      (Примечание: этот тестовый запрос позволяет создавать выборку не более чем за два месяца.)

4. Конструктор запросов:
В справке есть встроенный конструктор запросов: https://dev.wildberries.ru/swagger/analytics

Чтобы полноценно взаимодействовать с ним, нужно ввести токен, который сгенерировали в кабинете продавца и нажать по кнопке "Authoriz". В целом тут все интуитивно понятно, главное при работе с конструктором читайте внимательно описание параметров и комментарии.

5. Генерация ключей:
Любые ключи (рабочие и тестовые) можно получить в реальном кабинете селлера. Вы можете генерировать токены отдельно для каждой категории или сразу для нескольких, что повышает безопасность. Ссылка на личный кабинет продавца: https://seller.wildberries.ru/supplier-settings/access-to-api.

6. Формирование запроса в 1С:
Чтобы построить корректный запрос в 1С, нужно добавить в начало токена заголовок авторизации `Bearer `(с пробелом).

Пример реализации запроса остатков на складе WB в 1С выглядит следующим образом: