# Получить комментарии к рабочему отчёту

> **Метод в процессе раскатки — обновление `timeman 26.600.0`.** Доступен не на всех порталах. Новое чтение дополнительно включается командой VibeCode; при выпуске оно выключено. До включения или на портале без нового метода API отвечает `422 METHOD_NOT_YET_AVAILABLE`. Различайте раскатку по коду ошибки, а не по статусу: прочие отказы Битрикс24 приходят с тем же статусом 422 и кодом `BITRIX_ERROR`. Существующее чтение отчётов и дней продолжает работать.

`GET /v1/workday/work-reports/:id/comments`

Читает опубликованные комментарии отправленного рабочего отчёта из ленты. ID объекта берите из [списка рабочих отчётов](/docs/workday/work-reports/list).

**Скоуп:** `timeman`

## Параметры

| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| `id (path)` | integer | да | Положительный целый ID не больше 9007199254740991 из [списка рабочих отчётов](/docs/workday/work-reports/list) |
| `limit (query)` | integer | нет | Размер страницы: 1–50, по умолчанию 50 |
| `offset (query)` | integer | нет | Смещение: 0–999999999, по умолчанию 0; несовместим с page |
| `page (query)` | integer | нет | Номер страницы от 1; несовместим с offset. Вычисленное смещение не больше 999999999 |

## Примеры

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

```bash
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/workday/work-reports/79/comments?limit=50&offset=0"
```

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

```bash
curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  "https://vibecode.bitrix24.tech/v1/workday/work-reports/79/comments?limit=50&offset=0"
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports/79/comments?limit=50&offset=0', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const body = await res.json()
if (!res.ok) throw new Error(`${body.error?.code ?? res.status}: ${body.error?.message ?? res.statusText}`)
console.log(body.data, body.meta)
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports/79/comments?limit=50&offset=0', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const body = await res.json()
if (!res.ok) throw new Error(`${body.error?.code ?? res.status}: ${body.error?.message ?? res.statusText}`)
console.log(body.data, body.meta)
```

## Поля ответа

| Поле | Тип | Описание |
|---|---|---|
| `success` | boolean | `true` при успешном ответе |
| `data` | array | Комментарии запрошенной страницы; пустой массив допустим |
| `data[].id` | integer \| null | ID комментария; положительный, если не `null` |
| `data[].reportId` | integer | ID из [списка рабочих отчётов](/docs/workday/work-reports/list), совпадает с ID в пути запроса |
| `data[].authorId` | integer \| null | [ID пользователя](/docs/entities/users/get) Битрикс24; допустим 0 |
| `data[].text` | string \| null | Исходный BBCode, включая `[USER=…]` и `[DISK FILE ID=…]` |
| `data[].textPlain` | string \| null | Текст без BBCode и HTML |
| `data[].createdAt` | string \| null | Дата DATE_ATOM с сохранённым часовым поясом сервера |
| `meta.limit` | integer | Применённый размер страницы |
| `meta.offset` | integer | Применённое смещение |
| `meta.hasMore` | boolean | Страница заполнена, поэтому могут быть ещё комментарии |
| `meta.nextOffset` | integer \| null | Следующее смещение при полной странице; иначе `null` |

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

```json
{
  "success": true,
  "data": [{
    "id": 1,
    "reportId": 79,
    "authorId": 7,
    "text": "[USER=7]Alex[/USER] [DISK FILE ID=4]",
    "textPlain": "Alex",
    "createdAt": "2026-11-11T10:00:00+00:00"
  }],
  "meta": { "limit": 50, "offset": 0, "hasMore": false, "nextOffset": null }
}
```

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

502 — портал вернул повреждённые данные комментариев:

```json
{
  "success": false,
  "error": {
    "code": "BITRIX_UNAVAILABLE",
    "message": "Bitrix24 returned an unexpected comment response."
  }
}
```

## Ошибки

| HTTP | Код | Причина |
|---|---|---|
| 400 | `INVALID_PARAMS` | Некорректный ID, пагинация, неизвестные или повторённые параметры |
| 409 | `TIMEMAN_MODULE_NOT_ENABLED` | Инструмент учёта времени выключен |
| 422 | `METHOD_NOT_YET_AVAILABLE` | Новое чтение не включено в VibeCode или метод отсутствует на портале |
| 422 | `BITRIX_ERROR` | Прочие отказы Битрикс24; пояснение в message |
| 502 | `BITRIX_UNAVAILABLE` | Портал недоступен или вернул повреждённый ответ; частичной выдачи нет |
| 401 | `MISSING_API_KEY` | Не передан X-Api-Key |
| 401 | `INVALID_API_KEY` | API-ключ не опознан |
| 401 | `KEY_EXPIRED` | Срок действия API-ключа истёк |
| 401 | `TOKEN_MISSING` | Нет портальных учётных данных |
| 402 | `ACCOUNT_FROZEN` | Баланс портала заморожен |
| 403 | `SCOPE_DENIED` | У ключа нет скоупа timeman |
| 403 | `BITRIX_ACCESS_DENIED` | Нет права доступа к объекту |
| 429 | `RATE_LIMITED` | Превышен лимит темпа этого эндпоинта |
| 429 | `RATE_LIMITED` | Превышен лимит запросов портала Битрикс24 |
| 500 | `INTERNAL_ERROR` | Непредвиденная внутренняя ошибка |

Общие ошибки API описаны в разделе [Ошибки](/docs/errors).

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

Комментарии отсортированы по возрастанию ID. Передавайте `meta.nextOffset` как `offset`, пока `meta.hasMore` равно `true`. Полная страница означает, что комментарии могут продолжаться: после последней полной страницы может понадобиться ещё один пустой запрос. Общее количество не подставляется.

Произвольные `filter` и `select`, неизвестные и повторённые параметры отклоняются. Служебные сообщения исключены. У отчётов, подготовленных BitrixGPT, комментариев нет — возвращается пустой список.

Ключи `READONLY` поддерживаются. Личный ключ читает правами владельца вебхука; ключ приложения — правами пользователя учётных данных Битрикс24. Доступны свои объекты и объекты сотрудников, чей учёт времени вызывающий вправе смотреть. Недоступный или несуществующий объект, а также неотправленный отчёт, приводит к 403 на весь запрос.

Настроенный лимит — 30 запросов в минуту на пару ключа и пользователя. Действующее значение передаётся в `x-ratelimit-limit`.

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

- [Рабочие отчёты](/docs/workday/work-reports)
- [История рабочих дней](/docs/workday/records)
