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

Список обращений

GET /v1/feedback

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

Параметры

Параметр Тип Обяз. По умолч. Описание
Параметрstatus (query) Типstring Обяз.нет По умолч.— ОписаниеNEW, REVIEWING, AWAITING_USER, NEEDS_REVIEW, RESOLVED, ARCHIVED, WITHDRAWN. Регистр не важен
Параметрcategory (query) Типstring Обяз.нет По умолч.— ОписаниеBUG, SUGGESTION, DOCS, CHAT, BOTS, OTHER. Регистр не важен
Параметрoffset (query) Типnumber Обяз.нет По умолч.0 ОписаниеСколько записей пропустить
Параметрpage (query) Типnumber Обяз.нет По умолч.1 ОписаниеПостраничная пагинация. Используется, когда offset не задан
Параметрlimit (query) Типnumber Обяз.нет По умолч.20 ОписаниеРазмер страницы, от 1 до 100. Значение больше 100 урезается до 100, ноль и нечисловое значение заменяются на 20
Параметрfilter[status], filter[category] (query) Типstring Обяз.нет По умолч.— ОписаниеТе же два фильтра в скобочной форме
Параметрexported (query) Типstring Обяз.нет По умолч.— Описаниеtrue — только обращения, переданные разработчикам, false — только не переданные. Действует для ключа со скоупом vibe:feedback и ключа управления, остальным ключам не применяется
ПараметрportalId (query) Типstring Обяз.нет По умолч.— ОписаниеUUID портала. Сужает выдачу ключа управления до одного портала, другим ключам не применяется

Для листания используйте offset — например offset=100&limit=50. Поле offset в ответе повторяет применённое смещение. Если offset не передан, работает page.

Фильтры status и category регистронезависимы (status=new равнозначно status=NEW). Неизвестное значение возвращает 400 INVALID_FILTER_VALUE — опечатка в фильтре отклоняется явно, а не приводит к выдаче всего списка.

Те же два фильтра принимаются в скобочной форме: filter[status]=NEW&filter[category]=BUG. Проверка та же — регистр не важен, неизвестное значение возвращает 400 INVALID_FILTER_VALUE. Если в запросе есть обе формы, применяется плоская. Значение, которое не является одиночным (filter[status][]=NEW), тоже отклоняется с 400 INVALID_FILTER_VALUE.

Примеры

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

Terminal 
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/feedback?status=NEW&category=BUG&limit=20"

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

Terminal 
curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  "https://vibecode.bitrix24.tech/v1/feedback?status=NEW&category=BUG&limit=20"

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback?status=NEW&category=BUG&limit=20',
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } },
)
const { data, total } = await res.json()

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

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback?status=NEW&category=BUG&limit=20',
  { headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN' } },
)
const { data, total } = await res.json()

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе
Полеdata Типarray ОписаниеМассив обращений
Поле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[].attachmentCount Типnumber ОписаниеКоличество вложений
Полеdata[].context Типobject · null ОписаниеИсходный JSON, переданный при создании
Полеdata[].portalId Типstring ОписаниеUUID портала, с которого отправлено обращение
Полеdata[].portalDomain Типstring ОписаниеДомен этого портала
Полеdata[].userId Типstring · null ОписаниеUUID пользователя, отправившего обращение. null у обращения без автора: например, автора удалили
Полеdata[].userName Типstring · null ОписаниеИмя этого пользователя. null вместе с userId
Полеdata[].apiKeyId Типstring · null ОписаниеID ключа, которым отправлено обращение
Полеdata[].securityFlags Типobject · null ОписаниеСлужебные отметки модерации. null, если отметок нет
Полеdata[].gitlabIssueIid Типnumber · null ОписаниеНомер задачи в трекере команды, если обращение передано разработчикам. Иначе null
Полеdata[].exportedAt Типstring · null ОписаниеКогда обращение передано разработчикам (ISO 8601). Иначе null
Полеdata[].createdAt Типstring ОписаниеДата создания (ISO 8601)
Полеdata[].resolvedAt Типstring · null ОписаниеДата закрытия, если есть
Полеtotal Типnumber ОписаниеОбщее количество записей под фильтром
Полеpage Типnumber ОписаниеТекущая страница
Полеlimit Типnumber ОписаниеРазмер страницы
Полеoffset Типnumber ОписаниеПрименённое смещение

Поля от context до 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,
      "attachmentCount": 0,
      "createdAt": "2026-04-19T10:30:00.000Z",
      "resolvedAt": null
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "offset": 0
}

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

400 — неизвестное значение фильтра:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_FILTER_VALUE",
    "message": "Invalid status 'BOGUS'. Allowed values: NEW, REVIEWING, AWAITING_USER, NEEDS_REVIEW, RESOLVED, ARCHIVED, WITHDRAWN."
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_FILTER_VALUE ОписаниеПередано неизвестное значение status или category
HTTP400 КодINVALID_INPUT Описаниеexported не равен true или false. Проверяется только для ключа со скоупом vibe:feedback и ключа управления
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key

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

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