OpenAPI

Готово

Для команд, которым нужен machine-readable API contract и совместимость с импортом в tools.

Используйте OpenAPI contract как machine-readable reference для API

YAML spec - это поверхность для скачивания контракта для генератора API-клиентов и API explorer.

Держите публичные docs и spec синхронизированными; если одно из них дрейфует, доверие теряется быстро.

Используйте эту страницу для объяснения работы со spec, а не для ручного дублирования каждого endpoint-а.

Раздел

Где лежит spec

Текущий исходный файл: docs/openapi/external-statistics-v1.yaml.

Импорт в Postman или другой клиент

1. Скачайте YAML-файл.
2. Импортируйте его в Postman, Insomnia или code generator.
3. Подставьте External API key в заголовок Authorization.

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

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

Справочник API

Готово

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

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

Готово

Модель безопасности 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 и генерации клиентов.

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

Справочник API

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