L'admin web di betool si basa su un'API REST autenticata (prefisso /api), utilizzabile anche dai tuoi script: dashboard personalizzate dei consumi, esportazione dei registri, monitoraggio del saldo dei crediti.
Autenticazione
Ogni chiamata porta un token di sessione in Authorization: Bearer. Per un uso automatizzato, crea un token CLI a lunga durata dal menu dell'organizzazione → Impostazioni dell'organizzazione → Token CLI (il valore in chiaro viene mostrato una sola volta, revocabile in qualsiasi momento, hashato lato server), poi scambialo con un token di sessione:
# 1. Scambiare il token CLI con una sessione (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. Chiamare l'API con la sessione
curl -H "Authorization: Bearer $BETOOL_SESSION" \
https://platform.betool.ai/api/auth/me
Un token CLI è associato a una organizzazione; smette di funzionare se il suo titolare viene disattivato o non è più membro attivo di questa organizzazione. I diritti seguono la sua membership.
Filtri
Gli endpoint di elenco accettano parametri propri di ciascuna risorsa (tipicamente un limit limitato lato server); i campi disponibili sono documentati dalla risposta stessa.
Endpoint principali
| Endpoint | Descrizione |
|---|---|
GET /api/auth/me | Identità, organizzazione attiva, membership |
GET /api/admin/models | Elenca i modelli (pipeline) |
GET /api/admin/llm/accounts | Elenca gli account LLM (segreto mascherato, has_api_key) |
GET /api/admin/billing/state | Piano, saldo dei crediti, ricarica automatica |
POST /api/admin/billing/topup | Ricarica manuale (link di pagamento) |
GET /api/admin/billing/usage | Registro dei consumi (limit ≤ 500, filtro source_kind) |
GET /api/admin/me/supervisor-reads | Registro di audit degli accessi cross-tenant |
Per pilotare la configurazione in linguaggio naturale (creare/modificare una pipeline tramite proposte, applicate solo una volta accettate), preferisci il server MCP: è la superficie progettata per i client esterni.
Webhook in uscita
Hai bisogno di inviare eventi ai tuoi sistemi? Emettili dalle tue pipeline con il nodo webhook_action — vedi Webhook in uscita.
Limitazione della frequenza
Gli endpoint di autenticazione (registrazione, login, reimpostazione) hanno un rate limit. Gli altri endpoint non hanno, a oggi, una quota pubblicata — un uso automatizzato intensivo deve restare ragionevole.
SDK
Nessun SDK ufficiale. L'API è abbastanza semplice da essere consumata da qualsiasi linguaggio con un client HTTP.
Se scrivi un SDK per la tua organizzazione, segnalacelo — lo elencheremo.