Список комментариев

GET /v1/tasks/:taskId/comments

Возвращает комментарии конкретной задачи. На новой карточке задачи список читается из чата, системные сообщения отфильтрованы. На старой — из блока комментариев в самой карточке.

Комментарии, оставленные до перехода портала на новую карточку, в чат не переезжают, поэтому у задачи с чатом часть комментариев может лежать в старом хранилище. Если чат прочитан до конца и не дал ни одного комментария, список дочитывает старое хранилище и отвечает из него; если чат при этом дочитать не удалось, старое хранилище всё равно читается, а чат в meta.sources не попадает. meta.sources называет хранилища, содержимое которых ответ узнал, а полноту прочитанного показывает meta.truncated: по паре этих полей видно, значит ли пустой data «комментариев нет» или «узнали только про одно из двух хранилищ».

Параметры

Примеры

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

curl "https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc" \
  -H "X-Api-Key: YOUR_API_KEY"

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

curl "https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

const url = 'https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc'
const res = await fetch(url, {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data, meta } = await res.json()
console.log(`Получено ${data.length} комментариев`)

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

const url = 'https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc'
const res = await fetch(url, {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

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

Поля ответа

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

{
  "success": true,
  "data": [
    {
      "id": 36559,
      "taskId": 289,
      "authorId": 1,
      "message": "Добавил черновик отчёта в комментарии — посмотри, пожалуйста.",
      "createdAt": "2026-05-13T12:30:58.000Z",
      "attachments": []
    },
    {
      "id": 36557,
      "taskId": 289,
      "authorId": 79,
      "message": "[USER=99]Зуля[/USER], готово, спасибо.",
      "createdAt": "2026-05-12T15:11:04.000Z",
      "attachments": []
    }
  ],
  "meta": {
    "total": 2,
    "hasMore": false,
    "sources": ["chat"]
  }
}

Пример комментария с непустым attachments — Получить комментарий.

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

400 — taskId не положительное целое:

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "taskId must be a positive integer"
  }
}

Ошибки

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

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

Окно просмотра при фильтрации. На новой карточке запрос с filter или сортировкой не по ID просматривает до 2000 самых новых сообщений чата задачи, включая системные уведомления, и отбирает подошедшие комментарии из них. Если история задачи длиннее или ограничена тарифом портала, приходит meta.truncated: true: за границей окна остались комментарии, которых нет в ответе, а meta.total считает только попавшие в окно. Это не признак следующей страницы — offset окно не сдвинет. Сузьте выборку фильтром по POST_DATE или AUTHOR_ID. По той же причине ?sort=post_date:asc на такой задаче вернёт самые старые комментарии в пределах окна, а не самые старые в задаче.

Фильтр и сортировка по автору — через AUTHOR_ID. Поля AUTHOR_NAME и AUTHOR_EMAIL принимаются на старой карточке и возвращают 400 на новой, поэтому запрос по имени автора работает не на каждом портале. Чтобы выборка не зависела от того, как настроен портал, найдите сотрудника через GET /v1/users и фильтруйте или сортируйте по AUTHOR_ID.

Список читает чат, если он у задачи есть. Когда у задачи есть чат, ответ собирается из его сообщений. Комментарии, написанные до перехода портала на новую карточку, в чат не переносились, поэтому, когда в чате нет ни одного своего комментария, список читает блок комментариев старой карточки и отвечает из него — прочитанные хранилища называет meta.sources. Получение по идентификатору и скачивание вложения смотрят оба хранилища, но находку НЕ гарантируют: просмотр идёт чат-первым, а идентификаторы чата и старой карточки лежат в разных пространствах и пересекаются по числу, поэтому на задаче с обоими хранилищами тот же номер может совпасть с чужим комментарием чата — и до старой карточки запрос не дойдёт. Разбор — «Совпадение номера ничего не значит» в Скачивание вложения; надёжный id берите из ответа по тому же хранилищу, а не из другого места. Если известен id — берите Получить комментарий, не полагайтесь на список.

Системные уведомления и конец списка. Системные уведомления о постановке задачи, смене срока и назначении исполнителя отфильтровываются на стороне API. Если срез состоит только из них, сервис дочитывает историю задачи дальше, а не отдаёт пустую страницу с приглашением листать: meta.hasMore: false и meta.total: 0 означают, что в прочитанном источнике комментариев действительно нет — то есть системными уведомлениями пустой ответ не объясняется. Действительно ли их нет у задачи, говорит meta.sources — окончательный ответ даёт только набор ["chat", "legacy"], см. следующую особенность. Раньше на такой задаче приходило {"data": [], "total": 1, "hasMore": true} при любом offset — цикл while (hasMore) offset += limit не завершался никогда. Ведите пагинацию по meta.hasMore и содержимому data.

Пустой data читается по meta.sources вместе с meta.truncated. Окончательное «комментариев у задачи нет» даёт набор ["chat", "legacy"] без meta.truncated: содержимое обоих хранилищ известно, и оба пусты. Тот же набор с truncated: true означает, что прочитано не всё — в том числе когда старое хранилище вернуло полную страницу и за ней могут быть ещё комментарии. Любой другой набор означает, что часть хранилищ не читалась, и пустой data про них не говорит ничего. ["legacy"] — чат не ответил: он отказал (нет права im, метод недоступен), форму его ответа не удалось разобрать либо обход оборвался. Задача, которой чат НЕ выделен, даёт этот набор только в пределах пятиминутного кэша (там отсутствие чата неотличимо от неразобранной формы); на СВЕЖЕЙ проверке её чат-хранилище доказанно пусто, и ответ несёт полный набор. ["chat"] — старое хранилище не читалось: чат отдал хотя бы один комментарий, и тогда дочитывание не запускается вовсе, либо оно не удалось. [] — не ответило ни одно. Ответ во всех случаях остаётся 200: мы отдаём то, что узнали, и называем это, вместо того чтобы уронить работающий запрос или выдать молчание за ответ.

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

• Получить комментарий
• Создать комментарий
• Пакет операций
• Задачи
• Лимиты и оптимизация