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

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

POST /v1/catalog-products/:productId/images

Загружает изображение товара каталога из содержимого в base64: детальную картинку, картинку анонса или картинку галереи. Тело запроса — плоский JSON.

Параметры

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

Поля запроса (body)

Поле	Тип	Обяз.	Описание
`type`	string	да	Вид изображения: `DETAIL_PICTURE` — детальная картинка, `PREVIEW_PICTURE` — картинка анонса, `MORE_PHOTO` — картинка галереи. Другое значение отклоняется до обращения к Битрикс24
`fileName`	string	да	Имя файла с расширением, например `photo.png`. Пустое имя не принимается
`fileContent`	string	да	Содержимое файла в base64

Других полей тело не принимает: лишнее поле, например description, возвращает 400 INVALID_PARAMS. Предел тела запроса — 40 MiB.

Примеры

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-products/7257/images" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "MORE_PHOTO",
    "fileName": "photo.png",
    "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQIHWP4z8DwHwAFgAI/ScL/nwAAAABJRU5ErkJggg=="
  }'

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

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-products/7257/images" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "MORE_PHOTO",
    "fileName": "photo.png",
    "fileContent": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQIHWP4z8DwHwAFgAI/ScL/nwAAAABJRU5ErkJggg=="
  }'

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/7257/images', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'MORE_PHOTO',
    fileName: 'photo.png',
    fileContent: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQIHWP4z8DwHwAFgAI/ScL/nwAAAABJRU5ErkJggg==',
  }),
})

const { success, data } = await res.json()
console.log('ID изображения:', data.id)

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/7257/images', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'MORE_PHOTO',
    fileName: 'photo.png',
    fileContent: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQIHWP4z8DwHwAFgAI/ScL/nwAAAABJRU5ErkJggg==',
  }),
})

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

Поля ответа

Успешная загрузка отвечает HTTP-статусом 201 Created.

Поле	Тип	Описание
`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"
  }
}

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

400 — неизвестный type, пустое имя файла, содержимое не в base64 или лишнее поле в теле: