La API de lionbackup

Crear proyectos, emitir y revocar tokens de backup, consultar zonas y organizaciones: una REST API con JSON, especificación OpenAPI 3.1 abierta y proveedor de Terraform. Aplica los mismos permisos que el portal.

Su primera llamada en tres pasos

1. Crear una cuenta de servicio y una clave

   En el portal, en Developer, cree una cuenta de servicio y una clave de API para ella. La cuenta de servicio tiene exactamente los permisos de su cuenta de usuario; la clave se muestra una sola vez.

2. Canjear la clave por un token de acceso

   La clave no es un bearer token. La canjea por un token de acceso válido durante 15 minutos:

   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. Enviar las peticiones con el token

   Todos los endpoints están bajo https://api.lionbackup.cloud/api/v1 y esperan el token en la cabecera Authorization:

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

Ejemplo: crear un proyecto y emitir un token write

Un proyecto necesita un nombre y el ID de su zona de almacenamiento. Un token de backup pertenece a un único proyecto: con un token write el cliente hace la copia, con un token read la restaura.

# Elegir la zona: solo se pueden usar zonas con status "active"
ZONE_ID=$(curl -s "$API/zones" -H "Authorization: Bearer $ACCESS_TOKEN" \
  | jq -r '.zones[] | select(.name == "de01-1") | .id')

# Crear el proyecto (rol owner o admin en la organización)
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, …
}}

# Emitir un token write para el cliente
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" es el token de backup y solo aparece en esta respuesta
{"token": {"id": "c4d1e8f2-…", "type": "write", "secret": "9f3e7b1c…"}}

Las respuestas y los ID se muestran abreviados. Un proyecto no se elimina, sino que se cierra con POST /projects/{projectId}/close: los tokens write se revocan de inmediato y los tokens read siguen siendo válidos para restauraciones durante el periodo de retención.

Todos los endpoints

Conviene saber

Especificación y Terraform

¿Preguntas sobre la API? Escríbanos a través del formulario de contacto.