метод REST scope: catalog

catalog.productImage.list

Получить список изображений товара

Кто может выполнять: администратор

Описание

Метод возвращает список изображений товара, головного товара, вариации или услуги.

Параметры

productId catalog_product.id обязательный

Идентификатор товара, головного товара, вариации или услуги.

Чтобы получить существующие идентификаторы, используйте следующие методы:
- для товаров — catalog.product.list
- для головных товаров — catalog.product.sku.list
- для вариаций товара — catalog.product.offer.list
- для услуг — catalog.product.service.list

select array необязательный

Массив со списком полей, которые необходимо выбрать (смотрите поля объекта catalog_product_image)

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"productId":1,"select":["id","name","productId","type","createTime","downloadUrl","detailUrl"]}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productImage.list

Ответ

HTTP-статус: 200

{
    "result": {
        "productImages": [
            {
                "createTime": "2024-10-17T10:48:05+03:00",
                "detailUrl": "\/upload\/iblock\/6f1\/bkm7jmwso31wisk423gtp28iagy2e8v0\/test.jpeg",
                "downloadUrl": "http:\/\/dev.bx\/rest\/download.json?sessid=ae1ada0e5c85babd18ce4af4c702d1d9\u0026token=catalog%7CaWQ9NzY1MSZfPTEzSk9hR2tKNHBRY1I2cFBPNjhvaTFHNTNiYjVsVmdx%7CImRvd25sb2FkfGNhdGFsb2d8YVdROU56WTFNU1pmUFRFelNrOWhSMnRLTkhCUlkxSTJjRkJQTmpodmFURkhOVE5pWWpWc1ZtZHh8YWUxYWRhMGU1Yzg1YmFiZDE4Y2U0YWY0YzcwMmQxZDki.iC0Yzi9feK8V1Zr0WSlp5GZpcmD0osnJGHN%2FZL%2FkQI4%3D",
                "id": 1,
                "name": "test.jpeg",
                "productId": 1,
                "type": "MORE_PHOTO"
            }
        ]
    },
    "total": 1,
    "time": {
        "start": 1729163241.324569,
        "finish": 1729163241.860237,
        "duration": 0.535667896270752,
        "processing": 0.19502019882202148,
        "date_start": "2024-10-17T14:07:21+03:00",
        "date_finish": "2024-10-17T14:07:21+03:00",
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

productImages catalog_product_image[]

Массив объектов с информацией о выбранных изображениях товара

total integer

Общее количество найденных записей

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":200040300010,
    "error_description":"Access denied"
}
Код Описание Значение
200040300010 Недостаточно прав для просмотра торгового каталога
200040300010 Недостаточно прав для просмотра товара
100 Не указан или пустой параметр productId
0 Товар с указанным идентификатором не найден
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.