Веб-панель администрирования betool опирается на аутентифицированный REST API (префикс /api), который можно использовать и из ваших скриптов: кастомные дашборды потребления, экспорт журналов, отслеживание баланса кредитов.
Аутентификация
Каждый вызов несёт токен сессии в Authorization: Bearer. Для автоматизированного использования создайте долгоживущий токен CLI через меню организации → Параметры организации → Токены CLI (значение в открытом виде показывается только один раз, токен можно отозвать в любой момент, на стороне сервера хранится его хеш), затем обменяйте его на токен сессии:
# 1. Échanger le token CLI contre une session (rate-limité : 10/min)
curl -X POST https://platform.betool.ai/api/auth/cli-login -H "Content-Type: application/json" -d "{\"token\": \"$BETOOL_CLI_TOKEN\"}"
# -> {"session_token": "...", "user": {...}, "active_org": {...}, ...}
# 2. Appeler l'API avec la session
curl -H "Authorization: Bearer $BETOOL_SESSION" https://platform.betool.ai/api/auth/me
Токен CLI закреплён за одной организацией; он перестаёт работать, если его владелец деактивирован или больше не является активным участником этой организации. Права следуют его членству.
Фильтрация
Эндпоинты списков принимают параметры, специфичные для каждого ресурса (как правило, limit, ограниченный на стороне сервера); доступные поля описаны в самом ответе.
Ключевые эндпоинты
| Эндпоинт | Описание |
|---|---|
GET /api/auth/me | Идентификация, активная организация, членства |
GET /api/admin/models | Список моделей (pipelines) |
GET /api/admin/llm/accounts | Список учётных записей LLM (секрет скрыт, has_api_key) |
GET /api/admin/billing/state | План, баланс кредитов, автопополнение |
POST /api/admin/billing/topup | Ручное пополнение (ссылка на оплату) |
GET /api/admin/billing/usage | Журнал потребления (limit ≤ 500, фильтр source_kind) |
GET /api/admin/me/supervisor-reads | Журнал аудита межтенантного доступа |
Для управления конфигурацией на естественном языке (создание/редактирование pipeline через предложения, применяемые только после их принятия) предпочитайте MCP-сервер: это поверхность, предназначенная для внешних клиентов.
Исходящие webhook
Нужно отправлять события в ваши системы? Отправляйте их из ваших pipelines с помощью узла webhook_action — см. Исходящие webhook.
Ограничение частоты запросов
Эндпоинты аутентификации (регистрация, вход, сброс пароля) ограничены по частоте. Для остальных эндпоинтов на сегодняшний день нет опубликованной квоты — интенсивное автоматизированное использование должно оставаться разумным.
SDK
Официального SDK нет. API достаточно прост, чтобы использовать его из любого языка с HTTP-клиентом.
Если вы напишете SDK для своей организации, сообщите нам — мы включим его в список.