Для AI-агентов: markdown этой страницы — /docs-content/entities/catalog-products/images-get.md индекс документации — /llms.txt

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

GET /v1/catalog-products/:productId/images/:imageId

Возвращает одно изображение товара каталога по его идентификатору: вид, имя файла, время создания и адрес картинки.

Параметры

Параметр Тип Обяз. Описание
productId (path) number да ID товара. Список: GET /v1/catalog-products. Подходит и ID головного товара из GET /v1/catalog-skus, вариации из GET /v1/catalog-offers или услуги из GET /v1/catalog-services
imageId (path) number да ID изображения. Список: GET /v1/catalog-products/:productId/images

Примеры

curl — личный ключ

Terminal 
curl "https://vibecode.bitrix24.tech/v1/catalog-products/7257/images/38993" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal 
curl "https://vibecode.bitrix24.tech/v1/catalog-products/7257/images/38993" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/7257/images/38993', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Файл:', data.name)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/7257/images/38993', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Изображение товара
data.id number ID изображения
data.productId number ID товара, которому принадлежит изображение
data.type string Вид изображения: DETAIL_PICTURE — детальная картинка, PREVIEW_PICTURE — картинка анонса, MORE_PHOTO — картинка галереи
data.name string Имя файла
data.createTime string | null Время создания в формате ISO 8601 со смещением часового пояса, либо null
data.detailUrl string Адрес изображения — путь от адреса портала, начинающийся с /, или абсолютный http/https URL. Без сессии портала адрес может быть недоступен. Это недоверенные данные — правила в разделе Изображения товара

Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 38993,
    "productId": 7257,
    "type": "MORE_PHOTO",
    "name": "photo.png",
    "createTime": "2026-10-08T23:59:02+03:00",
    "detailUrl": "https://cdn-ru.bitrix24.ru/b00000000/iblock/2ba/2bae996b883855a3997fde84f01c7aee/photo.png"
  }
}

Пример ответа при ошибке

404 — у товара нет изображения с таким imageId:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Catalog product image not found"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS productId не является каноническим положительным целым числом, например abc, 0 или значение за пределами безопасного диапазона JavaScript
400 INVALID_PARAMS imageId не является каноническим положительным целым числом
404 ENTITY_NOT_FOUND У товара нет изображения с таким imageId: оно удалено, принадлежит другому товару или не существует
404 ENTITY_NOT_FOUND Товара с таким productId нет
502 BITRIX_UNAVAILABLE Битрикс24 недоступен или вернул ответ, не прошедший проверку формы и безопасности
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 INVALID_API_KEY Ключ неверен
401 TOKEN_MISSING К ключу не привязаны токены Битрикс24
403 SCOPE_DENIED У ключа нет скоупа catalog
403 BITRIX_ACCESS_DENIED Битрикс24 запретил доступ к каталогу
429 RATE_LIMITED Превышен лимит запросов. Повторите после срока из заголовка Retry-After
429 OPERATION_TIME_LIMIT Исчерпан лимит времени операций Битрикс24. Повторите после срока из заголовка Retry-After
503 BITRIX_TIMEOUT Битрикс24 не ответил вовремя. Повторите после срока из заголовка Retry-After

Полный список общих ошибок API — Ошибки.

Смотрите также