Обзор REST API

Справочник сгенерирован из закоммиченного контракта. Замороженная машиночитаемая спецификация этой сборки — openapi.json; интерактивный обозреватель — https://entherium.duckdns.org:8443/reference.

Как вызывать API

• Базовый URL: https://entherium.duckdns.org:8443; все пути ниже — относительно него.
• Авторизация: всем эндпоинтам с данными нужен Authorization: Bearer <token>. Люди входят по OAuth2 password flow (POST /api/v1/auth/login); агенты — по scoped-токену, который выпускает владелец платформы — см. Аутентификация. Без токена отвечают только пробы здоровья, эта документация, обозреватель и спецификация.
• Ошибки: JSON {"detail": "<человекочитаемо>"}; часть эндпоинтов добавляет машинный code. Полный список — Справочник ошибок.
• Повторы: эндпоинты приёма задач и тикетов уважают заголовок Idempotency-Key (UUID); см. Лимиты.
• Группы и домены: справочник группирует операции по тегам контракта; карта MCP (list_domains, GET /api/) называет 28 capability-доменов — это другая ось (домен может охватывать несколько тегов или не иметь публичных операций), поэтому числа намеренно расходятся.

Группа	Операций
agent	2
analytics	4
architecture	2
auth	6
chat	1
cloudflare	6
cockpit	4
comments	5
cycles	4
docs	3
entities	12
errors	1
health	3
instances	8
integrations	3
lifecycles	6
localizations	1
metamodel	2
metering	4
ops	3
publish	3
runs	17
specs	6
sse	6
tasks	5
tickets	3