Если вы уже знакомы с документацией 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С выглядит следующим образом:
Примечание: Добавил файл с примером тестового и рабочего запросов. Собственно весь код в этом спойлере.
7. Полезные ссылки:
- Хорошая коллекция запросов для Postman находится здесь: https://www.postman.com/wbteam/wb-workspace/collection
- Инструкция по работе с ними: https://wbapi.ru/d/2-Полезные-ссылки/2
- Не официальная группа по обсуждению API Wildberries: https://t.me/wildberriesApiForDev
Надеюсь, что приведенные примеры и объяснения помогут вам быстрее освоиться с документацией и начать эффективно использовать API Wildberries в своих проектах. Если у вас есть вопросы, замечания, дополнения или требуется помощь, дайте знать! Или просто тапните по плюсу, если окажется полезным.
Проверено на следующих конфигурациях и релизах:
- Управление нашей фирмой, редакция 3.0, релизы 3.0.10.178
