[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Ftasks\u002Ftime\u002Flist":3,"docs-tabs-entities\u002Ftasks\u002Ftime\u002Flist":6},{"content":4,"lastmod":5},"\n## Список записей учёта времени\n\n`GET \u002Fv1\u002Ftasks\u002F:taskId\u002Ftime`\n\nВозвращает все записи учёта времени конкретной задачи, отсортированные по `id` (сначала новые).\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|---------|\n| `taskId` (path) | number | да | — | ID задачи |\n| `limit` (query) | number | | `50` | Размер страницы |\n| `offset` (query) | number | | `0` | Пропустить N записей |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Ftime\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Ftime\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Ftime', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data, meta } = await res.json()\nconst totalSeconds = data.reduce((sum, r) => sum + Number(r.seconds), 0)\nconsole.log(`Всего по задаче: ${totalSeconds \u002F 60} мин`)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftasks\u002F289\u002Ftime', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data, meta } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив записей учёта времени |\n| `data[].id` | string | Идентификатор записи |\n| `data[].taskId` | string | ID родительской задачи |\n| `data[].userId` | string | Автор. Профиль: `GET \u002Fv1\u002Fusers\u002F:userId` |\n| `data[].seconds` | string | Длительность в секундах |\n| `data[].minutes` | string | Длительность в минутах (производное от `seconds`) |\n| `data[].commentText` | string | Комментарий к записи |\n| `data[].source` | string | Источник: `2` — REST API |\n| `data[].createdDate` | datetime | Когда запись была создана |\n| `data[].dateStart` | datetime | Начало учтённого интервала (заполняется автоматически) |\n| `data[].dateStop` | datetime | Окончание учтённого интервала (заполняется автоматически) |\n| `meta.total` | number | Общее число записей учёта времени по задаче |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": \"163\",\n      \"taskId\": \"289\",\n      \"userId\": \"1\",\n      \"commentText\": \"Подготовка черновика\",\n      \"seconds\": \"1800\",\n      \"minutes\": \"30\",\n      \"source\": \"2\",\n      \"createdDate\": \"2026-05-13T16:15:43+03:00\",\n      \"dateStart\": \"2026-05-13T17:15:43+03:00\",\n      \"dateStop\": \"2026-05-13T17:15:43+03:00\"\n    },\n    {\n      \"id\": \"161\",\n      \"taskId\": \"289\",\n      \"userId\": \"1\",\n      \"commentText\": \"\",\n      \"seconds\": \"600\",\n      \"minutes\": \"10\",\n      \"source\": \"2\",\n      \"createdDate\": \"2026-05-13T16:15:41+03:00\",\n      \"dateStart\": \"2026-05-13T17:15:41+03:00\",\n      \"dateStop\": \"2026-05-13T17:15:41+03:00\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'task' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `task` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку при чтении — например, родительская задача отсутствует или удалена |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Сортировка по убыванию `id`.** Сначала возвращаются последние добавленные записи. `limit` и `offset` работают поверх этой сортировки.\n\n## Смотрите также\n\n- [Получить запись](.\u002Fget.md) — одна запись по `id`\n- [Добавить запись](.\u002Fcreate.md) — создание новой записи\n- [Обновить запись](.\u002Fupdate.md) — изменить длительность или комментарий\n- [Удалить запись](.\u002Fdelete.md) — снять запись\n- [Задачи](\u002Fdocs\u002Fentities\u002Ftasks) — родительская сущность\n","2026-07-01",{}]