Для 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[].mime string Тип файла: image/webp или image/gif
data.attachments[].sizeBytes number Размер в байтах
data.attachments[].width number Ширина в пикселях
data.attachments[].height number Высота в пикселях
data.attachments[].originalName string Имя исходного файла
data.attachments[].createdAt string Дата привязки (ISO 8601)
data.comments array Комментарии обращения
data.comments[].id string UUID комментария
data.comments[].authorType string USER или PLATFORM
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 Дата закрытия, если есть

Ключ со скоупом vibe:feedback дополнительно получает portalDomain, userName, userId.

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

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 Код Описание
404 NOT_FOUND Обращение не существует или недоступно ключу
401 MISSING_API_KEY Не передан заголовок X-Api-Key

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

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

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

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

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