API admin
L'admin web de betool s'appuie sur une API REST authentifiée (préfixe /api), utilisable aussi depuis vos scripts : dashboards custom de consommation, export de journaux, suivi du solde de crédits.
Authentification
Chaque appel porte un jeton de session en Authorization: Bearer. Pour un usage automatisé, créez un token CLI longue durée depuis le menu de l'organisation → Paramètres de l'organisation → Tokens CLI (le clair n'est affiché qu'une fois, révocable à tout moment, haché côté serveur), puis échangez-le contre un jeton de session :
# 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
Un token CLI est épinglé sur une organisation ; il cesse de fonctionner si son porteur est désactivé ou n'est plus membre actif de cette organisation. Les droits suivent son membership.
Filtrage
Les endpoints de liste acceptent des paramètres propres à chaque ressource (typiquement un limit borné côté serveur) ; les champs disponibles sont documentés par la réponse elle-même.
Endpoints principaux
| Endpoint | Description |
|---|---|
GET /api/auth/me | Identité, organisation active, memberships |
GET /api/admin/models | Lister les modèles (pipelines) |
GET /api/admin/llm/accounts | Lister les comptes LLM (secret masqué, has_api_key) |
GET /api/admin/billing/state | Plan, solde de crédits, auto-recharge |
POST /api/admin/billing/topup | Recharge manuelle (lien de paiement) |
GET /api/admin/billing/usage | Journal de consommation (limit ≤ 500, filtre source_kind) |
GET /api/admin/me/supervisor-reads | Journal d'audit des accès cross-tenant |
Pour piloter la configuration en langage naturel (créer/éditer un pipeline par propositions, appliquées seulement une fois acceptées), préférez le serveur MCP : c'est la surface conçue pour les clients externes.
Webhooks sortants
Besoin de pousser des événements vers vos systèmes ? Émettez-les depuis vos pipelines avec le nœud webhook_action — voir Webhooks sortants.
Rate limiting
Les endpoints d'authentification (signup, login, réinitialisation) sont rate-limités. Les autres endpoints n'ont pas de quota publié à ce jour — un usage automatisé intensif doit rester raisonnable.
SDK
Pas de SDK officiel. L'API est suffisamment simple pour être consommée depuis n'importe quel langage avec un client HTTP.
Si vous écrivez un SDK pour votre organisation, signalez-le — nous le référencerons.