Загрузка фото через API Ozon: product/import/pictures, MAIN и GALLERY
API Ozon принимает изображения по ссылкам и разделяет главное фото и галерею на уровне запроса. Разбираем, как собрать запрос, какие ссылки принимаются и почему сухой прогон перед боевой заливкой обязателен.
Филимонов Иван2 мин чтения
Как устроен метод
Запрос содержит идентификатор товара и списки ссылок: отдельно главное изображение, отдельно галерея в нужном порядке. Площадка скачивает файлы сама, поэтому ссылки должны быть доступны без авторизации и вести на файл нужного формата. Обработка идёт асинхронно: статус загрузки проверяется отдельным запросом.
MAIN и GALLERY
Главное изображение в запросе — одно, и к нему применяются правила главного слота: без текста и инфографики, профиль sRGB, соотношение по категории. Галерея — упорядоченный список; порядок в запросе — порядок в карточке. Конвейер помечает слоты типом при сборке, и в запрос главное и галерея уходят раздельно без ручной сортировки.
Частые ошибки
- Ссылка на страницу вместо файла или файл за авторизацией.
- Файл не в sRGB или не того размера — импорт проходит, но карточку отклоняет модерация.
- Главное фото с текстом.
- Нарушенный порядок галереи из-за несортированного списка.
Сухой прогон
Боевая заливка меняет живую карточку. Поэтому запрос сначала формируется и показывается — со всеми ссылками, типами слотов и порядком, — и только после подтверждения уходит. В SnapShelf это режим по умолчанию: заливка включается явно.
Вопросы по теме статьи
Принимает ли API Ozon файлы напрямую?
Метод импорта картинок работает по ссылкам: площадка скачивает файлы сама. Ссылки должны быть публичными.
Как задать главное фото через API?
Отдельным полем в запросе; к нему применяются правила главного слота — без текста и в sRGB.
Как узнать, что картинки загрузились?
Статус импорта проверяется отдельным запросом; обработка асинхронная.
Услуга
Карточки для Ozon
Всё, о чём написано выше, конвейер SnapShelf делает сам: одно фото на входе, карточка по правилам площадки на выходе. При регистрации начисляются кредиты на пробу, карту вводить не нужно.
Читайте дальше
Главное фото Ozon без текста
Ozon запрещает на главном изображении надписи, плашки, цены и водяные знаки. Разбираем, что именно считается текстом, как выглядит главное фото, которое проходит, и где живёт инфографика.
sRGB на Ozon: почему цвет уезжает
Ozon принимает только sRGB. Что происходит с фото в Adobe RGB и CMYK при загрузке, почему белое становится кремовым и как привести цвет к нужному профилю без потери оттенка.
Размеры фото для Ozon
Минимальные разрешения, соотношения сторон по категориям, вес и формат — и как не держать два комплекта фото для Ozon и Wildberries.