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

Получить обращение

GET /v1/feedback/:id

Возвращает одно обращение по ID со всеми полями списка плюс context, вложения и комментарии.

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типstring Обяз.да ОписаниеUUID обращения. Получить из списка обращений или ответа на создание

Примеры

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

Terminal 
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666"

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

Terminal 
curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  "https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666"

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666',
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } },
)
const { data } = await res.json()

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666',
  { headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN' } },
)
const { data } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata.id Типstring ОписаниеUUID обращения
Полеdata.category Типstring ОписаниеКатегория
Полеdata.title Типstring ОписаниеЗаголовок
Полеdata.body Типstring ОписаниеОписание
Полеdata.status Типstring ОписаниеТекущий статус
Полеdata.source Типstring Описаниеapi или ui
Полеdata.resolution Типstring · null ОписаниеВердикт, записанный при последнем закрытии обращения. Пусто, если обращение ни разу не закрывали. Переоткрытие вердикт сохраняет, поэтому поле бывает заполнено и на активном обращении — за последним ответом команды идите в ленту комментариев
Полеdata.context Типobject · null ОписаниеИсходный JSON, переданный при создании
Полеdata.attachments Типarray ОписаниеВложения обращения
Полеdata.attachments[].id Типstring ОписаниеUUID вложения
Полеdata.attachments[].kind Типstring ОписаниеКласс вложения: IMAGE или DOCUMENT
Полеdata.attachments[].mime Типstring ОписаниеТип файла. У изображения — image/webp или image/gif. У документа — тип по расширению, например text/plain или application/zip
Полеdata.attachments[].sizeBytes Типnumber ОписаниеРазмер в байтах
Полеdata.attachments[].width Типnumber ОписаниеШирина в пикселях. У документа 0
Полеdata.attachments[].height Типnumber ОписаниеВысота в пикселях. У документа 0
Полеdata.attachments[].originalName Типstring · null ОписаниеИмя исходного файла. null, если изображение загружено без имени файла. У документа без имени приходит attachment.<расширение>
Полеdata.attachments[].createdAt Типstring ОписаниеДата загрузки файла (ISO 8601). Привязка к обращению или комментарию её не меняет, поэтому она бывает раньше даты создания обращения или комментария
Полеdata.comments Типarray ОписаниеКомментарии обращения
Полеdata.comments[].id Типstring ОписаниеUUID комментария
Полеdata.comments[].authorType Типstring ОписаниеUSER или PLATFORM
Полеdata.comments[].authorName Типstring · null ОписаниеИмя автора комментария. Заполняется для ключа со скоупом vibe:feedback и ключа управления, остальным приходит null
Полеdata.comments[].body Типstring ОписаниеТекст комментария
Полеdata.comments[].createdAt Типstring ОписаниеДата создания (ISO 8601)
Полеdata.comments[].attachments Типarray ОписаниеВложения комментария, та же структура, что data.attachments[]
Полеdata.createdAt Типstring ОписаниеДата создания (ISO 8601)
Полеdata.resolvedAt Типstring · null ОписаниеДата закрытия, если есть
Полеdata.portalId Типstring ОписаниеUUID портала, с которого отправлено обращение
Полеdata.portalDomain Типstring ОписаниеДомен этого портала
Полеdata.userId Типstring ОписаниеUUID пользователя, отправившего обращение. У обращения без автора ключа нет: например, автора удалили
Полеdata.userName Типstring ОписаниеИмя этого пользователя. Приходит вместе с userId
Полеdata.securityFlags Типobject · null ОписаниеСлужебные отметки модерации. null, если отметок нет
Полеdata.gitlabIssueIid Типnumber · null ОписаниеНомер задачи в трекере команды, если обращение передано разработчикам. Иначе null
Полеdata.exportedAt Типstring · null ОписаниеКогда обращение передано разработчикам (ISO 8601). Иначе null

Поля от portalId до exportedAt приходят только ключу со скоупом vibe:feedback и ключу управления.

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

JSON 
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-1111-2222-3333-444455556666",
    "category": "BUG",
    "title": "POST /v1/deals/search возвращает 500 при пустом filter",
    "body": "При вызове POST /v1/deals/search с телом {\"filter\":{}} приходит 500.",
    "status": "NEW",
    "source": "api",
    "resolution": null,
    "context": { "endpoint": "/v1/deals/search", "httpStatus": 500 },
    "attachments": [],
    "comments": [],
    "createdAt": "2026-04-19T10:30:00.000Z",
    "resolvedAt": null
  }
}

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

404 — обращение не найдено или недоступно ключу:

JSON 
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Feedback not found"
  }
}

Ошибки

HTTP Код Описание
HTTP404 КодNOT_FOUND ОписаниеОбращение не существует или недоступно ключу
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key

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

Известные особенности

Какие обращения видит ключ. Ключ без скоупа vibe:feedback получает только обращения, отправленные им самим. Ключ со скоупом — все обращения своего портала, ключ управления — любые.

Единый ответ для «нет» и «чужой». Несуществующее обращение и обращение, недоступное ключу, возвращают одинаковый 404 NOT_FOUND. По коду ответа нельзя отличить «не существует» от «существует, но принадлежит другому» — это защита от перебора чужих обращений.

Вложения и комментарии приходят массивами. В отличие от списка, get возвращает attachments и comments в теле обращения. У нового обращения оба массива пустые.

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