Перейти к основному содержимому

Загрузить или обновить изображения товара

POST 
/v1/product/pictures/import

Метод для загрузки или обновления изображений товара.

При каждом вызове метода передавайте все изображения, которые должны быть на карточке товара. Например, если вы вызвали метод и загрузили 10 изображений, а затем вызвали метод второй раз и загрузили ещё одно, то все 10 предыдущих сотрутся.

Для загрузки передайте адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG.

Изображения в массиве images располагайте в соответствии с желаемым порядком на сайте. Главным будет первое изображение в массиве.

Для каждого товара вы можете загрузить до 30 изображений.

Для загрузки маркетингового цвета используйте поле color_image.

Подробнее о требованиях к фото в Базе знаний продавца

Если вы хотите изменить состав или порядок изображений, получите информацию с помощью метода /v3/product/info/list — в нём отображается текущий порядок и состав изображений. Скопируйте данные полей images и color_image, измените и дополните состав или порядок в соответствии с необходимостью.

Если вы обновили изображение по ссылке, но ссылка не изменилась, в методе /v1/product/import/info для изображения в параметре result.items.status вернётся skipped.

У метода есть лимит на количество операций c товарами в минуту и в сутки. Если вы превысите лимит, вернётся ошибка 429 с описанием в поле message и заголовками:

  • Item-Retry-After — время в минутах до обновления лимита. Для суточного лимита — время до 03:00 по московскому времени.
  • Item-Rate-Limit-Remaining — остаток операций до следующего сброса лимита.

Чтобы узнать лимит, используйте /v4/product/info/limit.

Request​

Responses​

Предварительный результат работы метода