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

Получить дневной отчёт

GET /v1/workday/records/:recordId/report

Возвращает дневной отчёт сотрудника по ID записи рабочего времени, к которой он относится.

Требуется скоуп timeman. Битрикс24 проверяет, может ли владелец учётных данных читать учёт рабочего времени сотрудника, чья это запись. Ключ READONLY может читать отчёты.

Параметры

Параметр Тип Обяз. По умолч. Описание
recordId (path) integer да — ID записи рабочего времени. Список: GET /v1/workday/records
withAi (query) boolean нет false true или 1 — добавить в ответ отчёт, который для записи составил AI или робот: его тип придёт в type, текст — в reportExtended. Читается сохранённый отчёт, новый не создаётся. Без отчёта сотрудника ответ — data: null, даже если отчёт AI или робота есть

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/workday/records/185/report" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/workday/records/185/report" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/records/185/report', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const { data } = await res.json()

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/records/185/report', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean true при успешном запросе
data object | null Дневной отчёт или null, если у записи нет отчёта сотрудника. Подробнее о полях — Поля отчёта
data.id integer ID дневного отчёта. Список: GET /v1/workday/daily-reports
data.recordId integer ID записи рабочего времени. Список: GET /v1/workday/records
data.userId integer ID сотрудника, чей это отчёт. Список: GET /v1/users
data.type string Тип отчёта: REPORT — отчёт сотрудника. С withAi=true — AI_REPORT или ROBOT_REPORT, если для записи есть отчёт AI или робота
data.report string Текст отчёта сотрудника в разметке BB-кода
data.reportPlain string Текст отчёта без разметки
data.timestamp string | null Время последнего сохранения отчёта
data.reportExtended string | null Текст отчёта AI или робота. Приходит с withAi=true, если такой отчёт есть, иначе null

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

У записи есть отчёт сотрудника:

JSON 
{
  "success": true,
  "data": {
    "id": 379,
    "recordId": 185,
    "userId": 101,
    "type": "REPORT",
    "report": "[b]Done:[/b] daily summary",
    "reportPlain": "Done: daily summary",
    "timestamp": "2026-10-07T08:11:53.000Z",
    "reportExtended": null
  }
}

У записи нет отчёта сотрудника:

JSON 
{
  "success": true,
  "data": null
}

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

404 — записи рабочего времени с таким recordId нет:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Record not found."
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS В recordId не положительное целое число, в withAi не true, false, 1 или 0, передан неизвестный параметр или один параметр передан дважды
404 ENTITY_NOT_FOUND Записи рабочего времени с таким recordId нет
403 BITRIX_ACCESS_DENIED У владельца учётных данных нет права читать учёт рабочего времени сотрудника, чья это запись. Без этого права отказ приходит и на свою запись
409 TIMEMAN_MODULE_NOT_ENABLED Учёт рабочего времени недоступен на портале
422 BITRIX_ERROR Битрикс24 отказал в операции
502 BITRIX_UNAVAILABLE Битрикс24 недоступен или вернул ответ неожиданной формы
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 TOKEN_MISSING Ключ приложения передан без токена сессии в Authorization: Bearer
401 INVALID_SESSION Токен сессии неверный или истёк
403 SCOPE_DENIED У ключа нет скоупа timeman
429 RATE_LIMITED Превышен лимит чтения отчётов — 30 запросов в минуту на пару ключ–пользователь. Действующее значение — в заголовке x-ratelimit-limit, потолок делится между репликами. Или превышен общий лимит запросов

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

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