Первый вызов External API Treker Zadachek за несколько минут

Начните с GET /projects, чтобы проверить scope и аутентификацию.

Затем запросите task или analytics data с тем же ключом и тем же форматом ответа.

Держите ключ на серверной стороне; публикация в браузере не входит в доверенную модель.

Раздел

Первый запрос

GET /projects

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

Раздел

Типичный следующий запрос

GET /tasks с includes

curl -H "Authorization: Bearer <external_api_key>" \\n  "https://treker-zadachek.ru/api/external/v1/projects/project_1/tasks?include=tags,watchers&updatedAfter=2026-05-01T00:00:00Z"

Раздел

Самые частые ранние ошибки

AUTH_REQUIRED: ключ не был отправлен.
INVALID_API_KEY или API_KEY_EXPIRED: проблема в жизненном цикле ключа.
ACCESS_DENIED: проект находится вне доступного scope.
VALIDATION_ERROR: переданы неподдерживаемые filters, includes или limit.

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

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

Обзор External API

Готово

Обзор External API Treker Zadachek: аутентификация, режимы scope, pagination, формат ответа и поддерживаемые поверхности данных.

Справочник API

Готово

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

Ошибки и troubleshooting

Готово

Типовые ошибки Treker Zadachek MCP и API: проблемы auth, отказы доступа, stale context и packet authorization denial.

Коротко

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

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

Обзор External API

Справочник API