---
title: Обзор REST API
description: REST API платформы по тегам — 26 групп, сгенерировано из OpenAPI-контракта.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/api/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

Справочник сгенерирован из закоммиченного контракта. Замороженная машиночитаемая спецификация этой сборки — [openapi.json](/developers/api/openapi.json); интерактивный обозреватель — [https://entherium.duckdns.org:8443/reference](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-токену, который выпускает владелец платформы — см. [Аутентификация](../guides/authentication/). Без токена отвечают только пробы здоровья, эта документация, обозреватель и спецификация.
- **Ошибки:** JSON `{"detail": "<человекочитаемо>"}`; часть эндпоинтов добавляет машинный `code`. Полный список — [Справочник ошибок](../reference/errors/).
- **Повторы:** эндпоинты приёма задач и тикетов уважают заголовок `Idempotency-Key` (UUID); см. [Лимиты](../reference/limits/#idempotency).
- **Группы и домены:** справочник группирует операции по тегам контракта; карта MCP (`list_domains`, `GET /api/`) называет 28 capability-доменов — это другая ось (домен может охватывать несколько тегов или не иметь публичных операций), поэтому числа намеренно расходятся.

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