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

После создания товара необходимо добавить изображения через API. Качественные фотографии ускоряют модерацию и идентификацию товаров на складе.

Методы API

Важно: Методы работают только с уже созданными товарами. Сначала создайте товар через v1.nomenclatures.store, получите lamoda_sku, затем добавляйте изображения.

Требования к изображениям

Добавление изображений (JSON-RPC)

Запрос

POST https://public-api-seller.lamoda.ru/jsonrpc/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..."
            }
        ]
    }
}

Параметры запроса

* Необходимо указать либо base64 (для нового фото), либо external_id (для существующего). Нельзя указать оба поля одновременно.

Пакетная загрузка (REST)

Для загрузки изображений нескольких товаров одним запросом используйте batch-метод:

POST /api/v1/nomenclature/images/batch
Content-Type: multipart/form-data

matchingType: lamodaSku
images[]: SKU1_1.jpg
images[]: SKU1_2.jpg
images[]: SKU2_1.jpg

Параметры batch-запроса

Формат имени файла

При batch-загрузке SKU и порядковый номер определяются из имени файла:

{SKU}_{ImageNumber}.jpg

Примеры:

• MP002XM0ABCD01_1.jpg — первое (главное) фото для SKU MP002XM0ABCD01
• MP002XM0ABCD01_2.jpg — второе фото для того же SKU
• SELLER-SKU-001_1.jpeg — первое фото (при matchingType=supplierSku)

Ошибка при неверном формате:

{"message": "Wrong image name format. Valid pattern \"SKU_ImageNumber.jpg(jpeg)\""}

Получение существующих изображений

Информация об изображениях возвращается в ответе методов v1.nomenclatures.list и v1.attributes.sku.list:

"images": {
    "default": [
        {
            "external_id": "img_12345",
            "order": 1,
            "url": "https://a.lmcdn.ru/product/..."
        },
        {
            "external_id": "img_12346",
            "order": 2,
            "url": "https://a.lmcdn.ru/product/..."
        }
    ],
    "img320x461": [...]
}

Изменение порядка фотографий

Для изменения порядка передайте external_id с новым order:

{
    "images": [
        {"external_id": "img_12346", "order": 1},
        {"external_id": "img_12345", "order": 2}
    ]
}

Удаление изображений

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

Например, чтобы оставить только первое фото:

{
    "images": [
        {"external_id": "img_12345", "order": 1}
    ]
}

Рекомендации по фотографиям

• Главное фото (order=1) — товар целиком, фронтальный вид
• Второе фото — товар сбоку или сзади
• Третье фото — детали (застёжки, подошва, ткань)
• Четвёртое фото — товар на модели (если применимо)

Типичные ошибки

Превышен лимит изображений

{"message": "Max count of images is 8"}

Причина: попытка загрузить более 8 изображений для одного SKU.
Решение: удалите лишние изображения или замените существующие.

Файл слишком большой

{"message": "The file is too large. Allowed maximum size is 2 MB"}

Причина: размер файла превышает 2 МБ.
Решение: сожмите изображение или уменьшите разрешение.

Неверный формат файла

{"message": "Incorrect mime type. Corrects types are image/jpg and image/jpeg"}

Причина: файл не является JPEG (например, PNG или WebP).
Решение: конвертируйте изображение в формат JPEG.

Неверное расширение файла

{"message": "Incorrect image format. Correct formats are jpg and jpeg"}

Причина: расширение файла не .jpg или .jpeg.
Решение: переименуйте файл с правильным расширением.

Товар не найден

{"message": "Nomenclature for sku XXX not found"}

Причина: неверный lamoda_sku или товар ещё не создан.
Решение: проверьте SKU через v1.nomenclatures.list.

Изображение слишком маленькое

{"message": "Image resolution is too small"}

Причина: разрешение менее 800×800 пикселей.
Решение: используйте изображения большего размера.

Конфликт полей external_id и base64

{"message": "Вы должны указать или external_id, или image, но не оба поля сразу"}

Причина: указаны оба поля одновременно.
Решение: используйте только одно из полей: base64 для новых фото, external_id для существующих.

Варианты загрузки

1. Через API (base64 / multipart) — вы загружаете изображения самостоятельно
2. Отправка на фотостудию — при использовании template=reduced товар отправляется на съёмку в Lamoda

Для reduced (сокращённое создание) изображения не обязательны — товар будет сфотографирован на стороне Lamoda. Для full создания изображения обязательны.

См. также

• Создание товаров
• Атрибуты и справочники
• Справочник кодов ошибок