Обзор REST API

Готово

Быстро понять форму HTTP API перед полным reference.

Читайте проекты, задачи, аналитику, комментарии и метаданные через scoped HTTP API

External API нужен BI, ETL, дашбордам, внутренним интеграциям и ограниченному intake project/task из MCP-моста.

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

Публичная поверхность в основном read-first, но поддерживает ограниченные create/final-stage write для IDE→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.
Ограниченные записи: POST /projects, POST /projects/:projectId/tasks, POST /projects/:projectId/tasks/:taskId/complete.
Метаданные markdown-документов.
Публичные verification flows для task work packet там, где внешний контракт уже существует.

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

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

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

Готово

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

Справочник API

Готово

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

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

Готово

Скачайте и используйте OpenAPI-спецификацию Treker Zadachek для tooling, генерации клиентов и исследования запросов.

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

Готово

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

Коротко

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

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

Workflow work packet

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