L’API lionbackup

Créer des projets, émettre et révoquer des jetons de sauvegarde, interroger zones et organisations : une API REST en JSON, avec spécification OpenAPI 3.1 ouverte et provider Terraform. Elle applique les mêmes droits que le portail.

Votre premier appel en trois étapes

1. Créer un compte de service et une clé

   Dans le portail, sous Developer, vous créez un compte de service et une clé d’API associée. Le compte de service a exactement les droits de votre compte utilisateur ; la clé n’est affichée qu’une seule fois.

2. Échanger la clé contre un jeton d’accès

   La clé n’est pas un bearer token. Vous l’échangez contre un jeton d’accès valable 15 minutes :

   ACCESS_TOKEN=$(curl -s https://authentik.prod.lionbackup.cloud/application/o/token/ \
     -d grant_type=client_credentials \
     -d client_id=lionbackup-api \
     -d client_secret="$LIONBACKUP_API_KEY" \
     -d scope="profile lionbackup_api" | jq -r .access_token)

3. Envoyer les requêtes avec le jeton

   Tous les endpoints se trouvent sous https://api.lionbackup.cloud/api/v1 et attendent le jeton dans l’en-tête Authorization :

   API=https://api.lionbackup.cloud/api/v1
   
   curl -s "$API/organizations" -H "Authorization: Bearer $ACCESS_TOKEN"
   
   # 200
   {"organizations": [{
     "id": "9b2e6c1a-…", "name": "Exemple SARL",
     "status": "approved", "role": "owner"
   }]}

Exemple : créer un projet et émettre un jeton write

Un projet a besoin d’un nom et de l’identifiant de sa zone de stockage. Un jeton de sauvegarde appartient à un seul projet : avec un jeton write, le client sauvegarde ; avec un jeton read, il restaure.

# Choisir la zone : seules les zones avec status "active" sont utilisables
ZONE_ID=$(curl -s "$API/zones" -H "Authorization: Bearer $ACCESS_TOKEN" \
  | jq -r '.zones[] | select(.name == "de01-1") | .id')

# Créer le projet (rôle owner ou admin dans l’organisation)
curl -s -X POST "$API/organizations/$ORG_ID/projects" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"name\":\"web-servers\",\"availability_zone_id\":\"$ZONE_ID\"}"

# 201
{"project": {
  "id": "ea1296ad-…", "name": "web-servers", "status": "active",
  "availability_zone_id": "b0000001-…", "alert_email": null, …
}}

# Émettre un jeton write pour le client
curl -s -X POST "$API/projects/$PROJECT_ID/tokens" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"write","operating_system":"Linux"}'

# 201 : "secret" est le jeton de sauvegarde et n’apparaît que dans cette réponse
{"token": {"id": "c4d1e8f2-…", "type": "write", "secret": "9f3e7b1c…"}}

Les réponses et les identifiants sont abrégés. Un projet n’est pas supprimé mais fermé avec POST /projects/{projectId}/close : les jetons write sont révoqués immédiatement, les jetons read restent valables pour les restaurations pendant la durée de rétention.

Tous les endpoints

Bon à savoir

Spécification et Terraform

Des questions sur l’API ? Écrivez-nous via le formulaire de contact.