API admin
Toute l'admin betool est accessible via une API REST authentifiée. C'est le canal pour automatiser : provisioning d'organisations à la volée, sync de pipelines depuis votre repo Git, dashboards custom, intégration ITSM.
Authentification
Token Bearer émis depuis Administration → Tokens dans votre organisation.
curl -H "Authorization: Bearer $BETOOL_TOKEN" \
https://platform.betoolia.com/api/admin/me
Le token est scopé sur une organisation et un rôle. Le rôle détermine ce que vous pouvez lire et écrire.
Pagination & filtrage
Tous les endpoints liste suivent la même convention :
?limit=50(défaut 25, max 200)?offset=0?sort=-created_at(préfixe-pour descendant)- Filtres ad-hoc :
?status=ok&created_after=2026-05-01
La réponse inclut un header X-Total-Count pour le pagination cursor-less.
Endpoints principaux
| Endpoint | Description |
|---|---|
GET /api/admin/me | Identité, organisation courante, rôle |
GET /api/admin/pipelines | Lister les pipelines |
POST /api/admin/pipelines | Créer un pipeline |
PATCH /api/admin/pipelines/{id} | Modifier |
GET /api/admin/pipelines/{id}/executions | Historique d'exécutions |
GET /api/admin/billing/balance | Solde de crédits |
POST /api/admin/billing/topup | Recharge manuelle |
GET /api/admin/me/content-reads | Journal d'audit des accès cross-tenant |
La documentation OpenAPI complète est disponible à /api/admin/openapi.json une fois connecté.
Idempotence
Les endpoints POST acceptent un header Idempotency-Key. Si vous renvoyez la même requête avec la même clé, vous obtenez la même réponse — utile pour la retry stratégie côté caller.
Webhooks sortants
Configurez betool pour vous notifier sur événements clés (exécution échouée, solde bas, nouvel utilisateur). Voir Webhooks sortants.
Rate limiting
Par défaut :
- 1000 requêtes / minute par token
- 100 requêtes / minute pour les endpoints d'écriture coûteux (création pipeline, batch import)
Sur le plan Enterprise, les limites sont configurables.
SDK
Pas (encore) de SDK officiels. 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.