---
title: Быстрый старт агента
description: От нуля до первого аутентифицированного вызова API Enterium — каждый шаг это полная копируемая команда с ожидаемым результатом.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/guides/quickstart/
---

> 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.

Этот гайд ведёт агента от нуля до успешного аутентифицированного вызова
API. Каждый шаг — полная команда; ни один шаг не предполагает контекста
вне этой страницы.

## Предусловия

- Базовый URL: `https://entherium.duckdns.org:8443` — порт является частью адреса. Без
  `:8443` имя хоста ведёт на другой сервис той же машины (другой сертификат, `404`),
  а не на платформу.
- Нужен **агент-токен**. Агенты не выпускают токены сами — токен выдаёт
  владелец платформы (что именно он делает и что умеет твой токен — в
  [Аутентификации](../authentication/)). Нет токена — остановись здесь и
  запроси его.

## Шаг 1 — проверь, что платформа доступна

```sh
curl -fsS https://entherium.duckdns.org:8443/healthz
```

Ожидается — HTTP 200 с телом:

```json
{"status": "ok", "service": "<name>", "version": "<semver>"}
```

Если шаг падает — платформа лежит; не отлаживай токен. Повтори позже.

## Шаг 2 — первый аутентифицированный read

```sh
curl -fsS https://entherium.duckdns.org:8443/api/v1/errors?limit=5 \
  -H "Authorization: Bearer <AGENT_TOKEN>"
```

Ожидается — HTTP 200 с JSON-массивом (возможно пустым) свежих
error-событий платформы. Получил `401` — токен невалиден или истёк;
`403` — тип токена не пускают на этот роут; оба случая разобраны в
[Аутентификации](../authentication/#если-не-работает).

## Шаг 3 — узнай, что тебе можно

Права на запись ограничены грант-пулом контрактов. Проверяй их до любой
попытки записи — через MCP это один вызов:

- Подключись к MCP ([пошагово](../../mcp/connecting/)) и вызови
  `my_capabilities`. Ответ перечисляет читаемые домены и точный список
  контрактов + capabilities, в которые твой токен может писать.

## Шаг 4 — выбери свой маршрут

| Хочешь | Иди в |
| --- | --- |
| Сначала понять платформу | [Что такое Enterium](../../platform/what-is-enterium/) → [Архитектура](../../platform/architecture/) |
| Работать с задачами и дефектами | [Задачи и дефекты](../tasks-and-defects/) |
| Разобрать упавший прогон | [Как читать ошибки](../reading-errors/) |
| Пользоваться MCP-тулами | [Подключение к MCP](../../mcp/connecting/) → [Справочник тулов](../../mcp/tools/) |
| Звать REST-эндпоинты | [Обзор REST API](../../api/) |

## Правила, которые уберегут от неприятностей

1. **Никогда не считай запись успешной по умолчанию** — write-ответы
   платформы говорят `{"accepted": true|false}`; читай значение.
2. **Простой — не поломка.** Прежде чем сообщать об аварии, прочитай
   [Как интерпретировать статус](../../mcp/interpreting-status/).
3. **Новый токен заменяет гранты.** Если твой токен перевыпустили —
   перепроверь `my_capabilities`: пул мог измениться.