REST API и SDK

Два независимых API: API агентов (ядро MindRoot — запуск задач, трассировка, ключи) и API витрины (реестр плагинов, установка, публикация). Первый работает в вашем контуре, второй — публичный каталог.

API агентов (в вашем контуре)

Запуск задачи

Python SDK

JavaScript

API витрины mindroot.ru

Публичный каталог плагинов и агентов. Все ответы в JSON, CORS открыт, ключ не требуется. Swagger доступен по адресу /api/swagger.

Пример: поиск плагина и план установки

Аутентификация и лимиты

• API агентов — API-ключ в query-параметре api_key либо JWT в заголовке Authorization: Bearer. Один ключ = один интеграционный сценарий: отзывается без влияния на остальные системы.
• RBAC — ключи привязаны к ролям: наблюдатель (только чтение логов), оператор (запуск агентов), администратор (изменение политик и ключей).
• Лимиты — на тарифе «Старт» 500 запусков в месяц, «Команда» — 25 000, «Бизнес» — 150 000. При превышении возвращается HTTP 429 с указанием лимита.

API провижининга контура

Тот же публичный API витрины умеет превращать агента в разворачиваемый контур: считает ресурсы и смету, генерирует IaC-пакет и возвращает журнал шагов.

Пример: смета и пакет для выделенного контура

curl -X POST https://mindroot.ru/api/provisioning/plan \
  -H 'Content-Type: application/json' \
  -d '{"agent_slug":"context_ads_specialist",
       "config":{"contour":"dedicated_vpc","provider":"vk_cloud","tasks_per_month":40000}}'

curl -X POST https://mindroot.ru/api/provisioning/deploy \
  -H 'Content-Type: application/json' \
  -d '{"agent_slug":"context_ads_specialist","config":{"contour":"on_premise","tenant":"bank"}}'

Вход, организации и роли

Витрина публична: каталог, карточки плагинов, скачивание пакетов и прайс доступны без входа. Всё, что связано с контурами, агентами и аккаунтом, требует токена — сессии пользователя или API-ключа организации.

Роли: владелец, администратор, разработчик агентов, оператор, наблюдатель. Права проверяются на каждом запросе; отказ приходит как 403 с названием недостающего права. Контур чужой организации отвечает 404 — как несуществующий.

Удаление организации необратимо: вместе с ней уходят контуры, их секреты и журналы, ключ шифрования, API-ключи и учётные записи сотрудников, у которых не остаётся других организаций. Поэтому запрос требует права delete_organization (только владелец) и подтверждения названием.

# токен сессии
TOKEN=$(curl -s -X POST localhost:8080/api/auth/login -H 'Content-Type: application/json' \
  -d '{"email":"owner@romashka.ru","password":"mindroot"}' | python3 -c 'import json,sys;print(json.load(sys.stdin)["token"])')

# тот же запрос с API-ключом организации
curl -s localhost:8080/api/contours -H 'Authorization: Bearer mrk_...'

Контур: работающий агент

После развёртывания с target=local у контура есть собственный HTTP-интерфейс. Задачи проходят один путь: подбор команды по формулировке → проверка политики → исполнение кода плагина → запись в аудит. Изменяющие операции ждут человека.

# задача агенту: чтение выполняется сразу, запись уходит на подтверждение
curl -X POST localhost:8080/c/$DEP/api/task -H 'Content-Type: application/json' \
  -d '{"text":"Добавь минус-слова к кампании 700112244: дешево, бесплатно","user":"Мария"}'

# решение человека
curl -X POST localhost:8080/c/$DEP/api/approve -H 'Content-Type: application/json' \
  -d '{"token":"ap-1a2b3c4d5e","user":"Мария"}'