Работа с изображениями

Новость на модерации

Обновлено

18.12.2025

Содержание статьи

После создания товара вы можете добавить изображения через API. Качественные фотографии ускоряют модерацию и идентификацию товаров на складе. 
 
 
<h2>Метод API</h2> 
 
POST v1.nomenclature-images.update — добавление, обновление и удаление изображений товара. 
 
 
Метод работает только с уже созданными товарами. Сначала создайте товар через /v1/nomenclatures.store, получите lamoda_sku, затем добавляйте изображения. 
 
 
<h2>Добавление изображений</h2> 
<pre> 
POST v1.nomenclature-images.update 
Content-Type: application/json 
 
{ 
 "jsonrpc": "2.0", 
 "id": "550e8400-e29b-41d4-a716-446655440000", 
 "method": "v1.nomenclature-images.update", 
 "params": { 
 "seller_id": 12345, 
 "lamoda_sku": "MP002XM0ABCD01", 
 "images": [ 
 { 
 "order": 1, 
 "base64": "/9j/4AAQSkZJRgABAQEASABIAAD..." 
 }, 
 { 
 "order": 2, 
 "base64": "/9j/4AAQSkZJRgABAQEASABIAAD..." 
 } 
 ] 
 } 
} 
</pre> 
 
<h2>Параметры изображения</h2> 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">order</td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Порядковый номер фото (1 = главное фото)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">base64</td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Изображение в кодировке base64 (для новых фото)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">external_id</td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">ID существующего фото (для изменения порядка)</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Получение существующих изображений</h2> 
 
Информация об изображениях возвращается в ответе /v1/nomenclatures.list и /v1/attributes.sku.list: 
 
<pre> 
"images": { 
 "default": [ 
 { 
 "external_id": "img_12345", 
 "order": 1, 
 "url": "<a class="txttohtmllink" href="https://a.lmcdn.ru/product/">https://a.lmcdn.ru/product/</a>." 
 }, 
 { 
 "external_id": "img_12346", 
 "order": 2, 
 "url": "<a class="txttohtmllink" href="https://a.lmcdn.ru/product/">https://a.lmcdn.ru/product/</a>." 
 } 
 ], 
 "img320x461": [...] 
} 
</pre> 
 
<h2>Изменение порядка фотографий</h2> 
 
Для изменения порядка передайте external_id с новым order: 
 
<pre> 
{ 
 "images": [ 
 {"external_id": "img_12346", "order": 1}, 
 {"external_id": "img_12345", "order": 2} 
 ] 
} 
</pre> 
 
<h2>Удаление изображений</h2> 
 
Для удаления изображения просто не включайте его в массив images. Все фото, не указанные в запросе, будут удалены. 
 
 
Например, чтобы оставить только первое фото: 
 
<pre> 
{ 
 "images": [ 
 {"external_id": "img_12345", "order": 1} 
 ] 
} 
</pre> 
 
<h2>Требования к изображениям</h2> 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Параметр</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Требование</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Формат</td> 
<td style="border: 1px solid #ddd; padding: 8px;">JPEG, PNG</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Минимальный размер</td> 
<td style="border: 1px solid #ddd; padding: 8px;">800x800 пикселей</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Рекомендуемый размер</td> 
<td style="border: 1px solid #ddd; padding: 8px;">1200x1600 пикселей</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Максимальный размер файла</td> 
<td style="border: 1px solid #ddd; padding: 8px;">10 МБ</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Фон</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Белый или светлый однотонный</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Количество фото</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Минимум 1, рекомендуется 3-5</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Рекомендации по фотографиям</h2> 
<ul> 
<li>Главное фото (order=1) — товар целиком, фронтальный вид</li> 
<li>Второе фото — товар сбоку или сзади</li> 
<li>Третье фото — детали (застёжки, подошва, ткань)</li> 
<li>Четвёртое фото — товар на модели (если применимо)</li> 
</ul> 
 
<h2>Типичные ошибки</h2> 
 
<h3>Товар не найден</h3> 
<pre> 
{"code": -32602, "message": "Nomenclature not found"} 
</pre> 
 
Причина: неверный lamoda_sku или товар ещё не создан. 
Решение: проверьте SKU через /v1/nomenclatures.list. 
 
 
<h3>Неверный формат изображения</h3> 
<pre> 
{"code": -32602, "message": "Invalid image format"} 
</pre> 
 
Причина: изображение не в формате JPEG/PNG или повреждено. 
Решение: проверьте base64-кодировку и формат файла. 
 
 
<h3>Изображение слишком маленькое</h3> 
<pre> 
{"code": -32602, "message": "Image too small"} 
</pre> 
 
Причина: размер менее 800x800 пикселей. 
Решение: используйте изображения большего размера. 
 
 
<h2>Варианты загрузки</h2> 
 
Есть два способа предоставить изображения: 
 
<ol> 
<li>Через API (base64) — вы загружаете изображения самостоятельно</li> 
<li>Отправка на фотостудию — при использовании template=create_reduced товар отправляется на съёмку в Lamoda</li> 
</ol> 
 
 
Для create_reduced (сокращённое создание) изображения не обязательны — товар будет сфотографирован на стороне Lamoda. Для full создания изображения обязательны.

Помогла эта информация?

Да Нет

Спасибо за отзыв

Отправить

Создание товаров

Атрибуты и справочники