Справочник API
Готово

Используйте как индекс endpoint-ов перед скачиванием OpenAPI-спецификации.

Проекты, задачи, комментарии, time, analytics, work packets, bughunt, repo-connection, ai-review и markdown-метаданные

API использует стабильные ответы для коллекций и одиночных ресурсов, cursor pagination и whitelist sort fields.
Tasks и comments поддерживают includes; analytics и time endpoint-ы — date range и breakdown mode.
OpenAPI остаётся поверхностью для скачивания контракта; эта страница объясняет структуру reference.

Раздел

Семейство projects

  • POST /projects
  • GET /projects
  • GET /projects/summary
  • GET /projects/:projectId
  • GET /projects/:projectId/users
  • GET /projects/:projectId/teams
  • GET /projects/:projectId/boards
  • GET /projects/:projectId/stages

Раздел

Семейство tasks и comments

  • POST /projects/:projectId/tasks
  • GET /projects/:projectId/tasks
  • GET /projects/:projectId/tasks/:taskId
  • POST /projects/:projectId/tasks/:taskId/complete
  • GET /projects/:projectId/comments
  • GET /projects/:projectId/comments/:commentId
  • Поддерживаемые task include values: tags, watchers.
  • Поддерживаемые comment include values: files.

Раздел

Семейство time и analytics

  • GET /projects/:projectId/time-entries
  • GET /projects/:projectId/time-entries/:timeEntryId
  • GET /projects/:projectId/analytics/overview
  • GET /projects/:projectId/analytics/progress
  • GET /projects/:projectId/analytics/time
  • GET /projects/:projectId/markdown-documents

Раздел

Семейство work packets и work requests

  • GET /projects/:projectId/task-work-packets/ready — очередь готовых пакетов (включая orphaned reclaim).
  • GET /projects/:projectId/task-work-packets/tasks/:taskId/packets, .../artifacts, .../proposals, .../convergence.
  • GET /projects/:projectId/task-work-packets/:packetId/context, .../readiness-validation, .../boundary-safety, .../convergence-candidate.
  • POST: packets-from-plan, approve-ready, claim, renew, release, progress-comments, artifacts, handoffs, recovery-wave, convergence-gate; PATCH :packetId/contract.
  • POST /projects/:projectId/work-requests, GET /work-requests/by-task/:taskId, GET /work-requests/:requestId, POST /work-requests/:requestId/promote-to-proposal.

Раздел

Семейство bughunt

  • POST /projects/:projectId/tasks/:taskId/bughunt — один цикл охоты (MCP: submit_bughunt_iteration). remainingOpen обязан равняться числу open findings.
  • GET /projects/:projectId/tasks/:taskId/bughunt/:findingId — полное тело находки (MCP: get_finding). Ответ плоский, поле inspection в единственном числе. 404 NOT_FOUND, если id нет на этой задаче.

Раздел

Семейство repo-connection (git-firewall)

  • POST /projects/:projectId/repo-connection — подключить SSH-репозиторий (git@host:path или ssh://; HTTPS отклоняется). Возвращает sshPublicKey для read-only deploy key.
  • GET /projects/:projectId/repo-connection — статус: verified/pending, lastFetchAt, lastFetchError.
  • DELETE /projects/:projectId/repo-connection — отключить; задачи не затрагиваются, git-проверка прекращается.

Раздел

Семейство ai-review (авто-ревьюер, advisory по умолчанию)

  • GET /projects/:projectId/ai-review — состояние авто-ревью проекта.
  • GET /projects/:projectId/ai-review/metrics — метрики: findingsCurve, same_model_review, verdict-история.
  • GET /projects/:projectId/ai-review/tasks/:taskId — вердикты и события по задаче.
  • POST /projects/:projectId/ai-review/verdicts и POST .../tick — только reviewer-принципал (TASKTRACKER_AI_REVIEW_PRINCIPAL_IDS); ключ проекта получает 403.

Следующие материалы

Связанные страницы

Коротко

О чём эта страница

External API Treker Zadachek

External API Treker Zadachek — scoped HTTP-поверхность для projects, tasks, comments, analytics и verification reads. Нужна интеграциям с прямым контрактом вместо MCP runtime.

FAQ

External API публичен и работает без аутентификации?

Нет. Публична документация, но сам API требует external API key и enforce-ит project scope через режимы selected_projects или all_projects.

Можно ли использовать API как source of truth после записи через MCP?

Да. Это рекомендуемая verification-модель, когда нужно независимое HTTP-подтверждение того, что workflow-мутация действительно изменила backend state.

Источники

Обзор External API

docs/api/external-statistics-api-overview.md

Высокоуровневая рамка API и модель аутентификации.

Reference External API

docs/api/external-statistics-api.md

Семейства HTTP endpoint-ов, filters, shape ответа и примеры.

Контракт OpenAPI

docs/openapi/external-statistics-v1.yaml

Machine-readable reference для tooling и генерации клиентов.

Читать дальше