La administración web de betool se apoya en una API REST autenticada (prefijo /api), que también puedes usar desde tus scripts: dashboards personalizados de consumo, exportación de registros, seguimiento del saldo de créditos.
Autenticación
Cada llamada lleva un token de sesión en Authorization: Bearer. Para un uso automatizado, crea un token CLI de larga duración desde el menú de la organización → Ajustes de la organización → Tokens CLI (el valor en claro solo se muestra una vez, revocable en cualquier momento, con hash del lado del servidor) y cámbialo por un token de sesión:
# 1. Cambiar el token CLI por una sesión (rate-limited: 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. Llamar a la API con la sesión
curl -H "Authorization: Bearer $BETOOL_SESSION" \
https://platform.betool.ai/api/auth/me
Un token CLI está vinculado a una organización; deja de funcionar si su titular se desactiva o ya no es miembro activo de esa organización. Los permisos siguen su membresía.
Filtrado
Los endpoints de listado aceptan parámetros propios de cada recurso (normalmente un limit acotado del lado del servidor); los campos disponibles los documenta la propia respuesta.
Endpoints principales
| Endpoint | Descripción |
|---|---|
GET /api/auth/me | Identidad, organización activa, membresías |
GET /api/admin/models | Listar los modelos (pipelines) |
GET /api/admin/llm/accounts | Listar las cuentas LLM (secreto oculto, has_api_key) |
GET /api/admin/billing/state | Plan, saldo de créditos, recarga automática |
POST /api/admin/billing/topup | Recarga manual (enlace de pago) |
GET /api/admin/billing/usage | Registro de consumo (limit ≤ 500, filtro source_kind) |
GET /api/admin/me/supervisor-reads | Registro de auditoría de los accesos cross-tenant |
Para gestionar la configuración en lenguaje natural (crear/editar un pipeline mediante propuestas, aplicadas solo una vez aceptadas), prefiere el servidor MCP: es la superficie diseñada para los clientes externos.
Webhooks salientes
¿Necesitas enviar eventos a tus sistemas? Emítelos desde tus pipelines con el nodo webhook_action — consulta Webhooks salientes.
Rate limiting
Los endpoints de autenticación (registro, inicio de sesión, restablecimiento) tienen limitación de tasa. Los demás endpoints no tienen cuota publicada a día de hoy — un uso automatizado intensivo debe seguir siendo razonable.
SDK
No hay SDK oficial. La API es lo bastante simple como para consumirla desde cualquier lenguaje con un cliente HTTP.
Si escribes un SDK para tu organización, avísanos — lo referenciaremos.