Reference API REST
L'API BeeBoop vous permet d'integrer les fonctionnalites de sauvegarde et restauration dans vos workflows d'automatisation.
Authentification
Toutes les requetes API doivent inclure un header d'authentification Bearer :
Authorization: Bearer VOTRE_CLE_API
Les cles API peuvent etre generees dans les parametres du compte.
URL de base
https://api.beeboop.net/v1
GET
/instances
Lister les instances
Exemple de reponse :
{ "data": [{ "uuid": "...", "name": "prod-db", "status": "online", "engine": "postgresql", "engine_version": "16.1" }] }
GET
/instances/{uuid}
Details d'une instance
Exemple de reponse :
{ "data": { "uuid": "...", "name": "prod-db", "status": "online", "last_base_backup_at": "2025-01-15T02:00:00Z", "last_wal_archived_at": "2025-01-15T14:30:00Z" } }
POST
/instances/{uuid}/preview
Lancer une previsualisation PITR
Exemple de reponse :
{ "data": { "uuid": "...", "status": "provisioning", "target_time": "2025-01-15T14:30:00Z" } }
GET
/instances/{uuid}/backups
Lister les sauvegardes
Exemple de reponse :
{ "data": [{ "uuid": "...", "type": "base_backup", "status": "completed", "size_bytes": 1073741824, "created_at": "2025-01-15T02:00:00Z" }] }
POST
/instances/{uuid}/restore
Lancer une restauration
Exemple de reponse :
{ "data": { "uuid": "...", "status": "pending", "target_time": "2025-01-15T14:30:00Z" } }
GET
/instances/{uuid}/alerts
Lister les alertes
Exemple de reponse :
{ "data": [{ "uuid": "...", "severity": "critical", "message": "Backup failed", "created_at": "2025-01-15T03:00:00Z" }] }
Limites de taux
L'API est limitee a 100 requetes par minute par cle API. Les headers X-RateLimit-Remaining et X-RateLimit-Reset sont inclus dans chaque reponse.