Die Web-Administration von betool stützt sich auf eine authentifizierte REST-API (Präfix /api), die auch aus Ihren Skripten nutzbar ist: individuelle Verbrauchs-Dashboards, Export von Protokollen, Überwachung des Credit-Guthabens.
Authentifizierung
Jeder Aufruf trägt ein Sitzungstoken in Authorization: Bearer. Für eine automatisierte Nutzung erstellen Sie über das Organisationsmenü → Organisationseinstellungen → CLI-Tokens ein langlebiges CLI-Token (der Klartext wird nur einmal angezeigt, jederzeit widerrufbar, serverseitig gehasht) und tauschen es dann gegen ein Sitzungstoken:
# 1. Das CLI-Token gegen eine Sitzung tauschen (ratenbegrenzt: 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. Die API mit der Sitzung aufrufen
curl -H "Authorization: Bearer $BETOOL_SESSION" \
https://platform.betool.ai/api/auth/me
Ein CLI-Token ist an eine Organisation gebunden; es funktioniert nicht mehr, wenn sein Inhaber deaktiviert wird oder kein aktives Mitglied dieser Organisation mehr ist. Die Rechte folgen seiner Mitgliedschaft.
Filterung
Die Listen-Endpunkte akzeptieren ressourcenspezifische Parameter (typischerweise ein serverseitig begrenztes limit); die verfügbaren Felder dokumentiert die Antwort selbst.
Wichtige Endpunkte
| Endpunkt | Beschreibung |
|---|---|
GET /api/auth/me | Identität, aktive Organisation, Mitgliedschaften |
GET /api/admin/models | Modelle (Pipelines) auflisten |
GET /api/admin/llm/accounts | LLM-Konten auflisten (Secret maskiert, has_api_key) |
GET /api/admin/billing/state | Plan, Guthabenstand, automatische Aufladung |
POST /api/admin/billing/topup | Manuelle Aufladung (Zahlungslink) |
GET /api/admin/billing/usage | Verbrauchsprotokoll (limit ≤ 500, Filter source_kind) |
GET /api/admin/me/supervisor-reads | Audit-Protokoll mandantenübergreifender Zugriffe |
Um die Konfiguration in natürlicher Sprache zu steuern (eine Pipeline per Vorschlag erstellen/bearbeiten, erst nach Annahme angewendet), nutzen Sie besser den MCP-Server: Er ist die für externe Clients konzipierte Oberfläche.
Ausgehende Webhooks
Sie möchten Ereignisse an Ihre Systeme senden? Senden Sie sie aus Ihren Pipelines mit dem Knoten webhook_action — siehe Ausgehende Webhooks.
Rate-Limiting
Die Authentifizierungs-Endpunkte (Registrierung, Anmeldung, Zurücksetzen) sind ratenbegrenzt. Für die übrigen Endpunkte ist derzeit kein Kontingent veröffentlicht — eine intensive automatisierte Nutzung sollte maßvoll bleiben.
SDKs
Es gibt kein offizielles SDK. Die API ist einfach genug, um sie aus jeder Sprache mit einem HTTP-Client zu konsumieren.
Wenn Sie ein SDK für Ihre Organisation schreiben, sagen Sie uns Bescheid — wir werden es aufführen.