Используйте как индекс endpoint-ов перед скачиванием OpenAPI-спецификации.
Проекты, задачи, комментарии, time, analytics, work packets, bughunt, repo-connection, ai-review и markdown-метаданные
Раздел
Семейство 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.
Следующие материалы
Связанные страницы
Спецификация OpenAPI
Скачайте и используйте OpenAPI-спецификацию Treker Zadachek для tooling, генерации клиентов и исследования запросов.
Быстрый старт с External API
Сделайте первый запрос к External API Treker Zadachek, проверьте auth и разберите базовые формы ответа и ошибки.
Примеры
Примеры запросов для Treker Zadachek MCP и External API: ready discovery, claim, progress, artifact, багхант и handoff.
Коротко
О чём эта страница
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 и генерации клиентов.
Читать дальше