Обзор REST API

Готово

Используйте эту страницу, когда нужно быстро понять форму HTTP API перед полным reference.

Читайте проекты, задачи, analytics, комментарии, time data и markdown metadata через scoped HTTP API

External API создан для BI tools, ETL jobs, dashboards, внутренних интеграций и bounded project/task intake из MCP bridge.

Он использует явные allowlist сериализации и project-scoped API key, а не продуктовые JWT endpoint-ы.

Публичная API-поверхность остаётся read-first, но поддерживает ограниченные create/final-stage write операции для IDE-to-MCP workflow.

Раздел

Аутентификация и scope

Authorization: Bearer <external_api_key> - основная документированная форма аутентификации.
X-API-Key тоже поддерживается.
Режимы scope: selected_projects и all_projects.
Запросы к чужим проектам возвращают 403 ACCESS_DENIED.

Список доступных проектов

curl -H "Authorization: Bearer <external_api_key>" \\n  "https://treker-zadachek.ru/api/external/v1/projects"

Раздел

Формат ответа

Ответ коллекции

{
  "data": [],
  "meta": {
    "limit": 100,
    "nextCursor": null,
    "hasMore": false
  }
}

Раздел

Поддерживаемые поверхности

Projects, users, teams, boards, stages.
Tasks, comments, time entries, analytics.
Bounded writes: POST /projects, POST /projects/:projectId/tasks, POST /projects/:projectId/tasks/:taskId/complete.
Метаданные markdown-документов.
Публичные verification flows для task work packet там, где внешний контракт уже существует.

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

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

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

Готово

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

Справочник API

Готово

Справочник по endpoint-ам TaskTracker External API, filters, pagination и типовым шаблонам запросов.

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

Готово

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

Безопасность и модель доступа

Готово

Модель безопасности TaskTracker MCP и External API: project scope, работа с API key, token redaction и безопасное поведение оператора.

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

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

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 и генерации клиентов.

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

Workflow work packet

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