Интеграция с Wildberries и Ozon по API

Для кого эта интеграция

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

• Селлеры с сотнями карточек на Wildberries и Ozon
• Бренды, которые продают одни и те же товары на обеих площадках
• Агентства и студии, которые ведут кабинеты нескольких клиентов
• Менеджеры маркетплейсов, отвечающие за контент карточек

Что Solistra читает

Чтение нужно, чтобы найти карточку и не потерять текущие фото. Solistra запрашивает список карточек и их изображения по артикулу продавца, nmID для Wildberries, offer_id или SKU для Ozon. Сверх этого данные магазина не читаются.

У каждого подключения в разделе «Интеграции» видно, что разрешено Solistra: находить карточки по артикулу, загружать фото в карточки и скачивать фото из карточек.

Что Solistra пишет

Единственное, что Solistra записывает в карточку, это итоговый список фото. Цены, остатки, описания, характеристики, видео карточек и заказы не меняются никогда.

Для Wildberries список фото передаётся методами раздела Content API, для Ozon методом импорта изображений товара по ссылкам. Фото уходят постоянными HTTPS ссылками на хранилище в России, без EXIF и с неугадываемым адресом.

Какие права выдать

Принцип простой: ключ даёт ровно то, что нужно для фото. Справка Wildberries объясняет, что даже при утечке токена доступ ограничен выбранными категориями данных.

Где хранятся ключи

Ключи шифруются и хранятся только на сервере в России. В браузер, логи и ответы API Solistra они не попадают. Запросы к Wildberries и Ozon уходят из России напрямую, без зарубежного шлюза.

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

Лимиты площадок и повторы

У API Wildberries и Ozon есть ограничения на частоту запросов. Solistra ставит отправки в очередь, соблюдает эти лимиты и на один кабинет держит один активный пакет.

Если площадка ответила, что запросов слишком много, или вернула временную ошибку сервера, Solistra делает паузу и повторяет. Если исход записи неясен, повторной записи вслепую нет: сначала Solistra читает карточку и сверяет, что в ней уже стоит.

Обратное чтение и история

После каждой записи Solistra читает карточку обратно и сравнивает фото с отправленным списком. Пока сверка не прошла, успех не показывается.

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

Как подключить

Подключение занимает несколько минут и не требует программиста.

• Создайте токен WB с категорией «Контент» или ключ Ozon с ролью для товаров
• Откройте «Интеграции» в Solistra и выберите площадку
• Вставьте ключ и нажмите «Проверить»
• Проверьте список разрешений подключения
• Перейдите в «Карточки» и отправьте первую серию