Справочник API

Готово

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

Projects, tasks, comments, time, analytics, metadata markdown и verification reads по work packet

API использует стабильные ответы для коллекций и одиночных ресурсов, cursor pagination и whitelisted 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

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

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

Спецификация OpenAPI

Готово

Скачайте и используйте OpenAPI specification TaskTracker для tooling, генерации клиентов и исследования запросов.

Быстрый старт с External API

Готово

Сделайте первый запрос к TaskTracker External API, проверьте auth и поймите базовые формы ответа и ошибки.

Примеры

Готово

Примеры запросов для TaskTracker MCP и External API: ready discovery, claim, progress, artifact и handoff.

Коротко по странице

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

TaskTracker External API

TaskTracker External API - это scoped HTTP surface для 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 и генерации клиентов.

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

Быстрый старт с External API

Спецификация OpenAPI