API REST

Pilotez chaque action du tableau de bord via HTTP avec une clé API bearer.

Chaque action du tableau de bord est aussi un endpoint REST sous https://gheima.ma/api/v1. Authentifiez-vous avec un jeton bearer ; les clés sont limitées à 120 requêtes par minute (voir les en-têtes de réponse X-RateLimit-*). La spécification complète est sur /api/v1/openapi.json.

Shell

# List services (cursor-paginated: ?limit=&cursor=&type=WEB|WORKER|STATIC)
curl "https://gheima.ma/api/v1/services?limit=20" \
  -H "Authorization: Bearer gh_xxxxx"

# Create a service
curl -X POST https://gheima.ma/api/v1/services \
  -H "Authorization: Bearer gh_xxxxx" -H "content-type: application/json" \
  -d '{"projectId":"prj_1","name":"web","repoUrl":"https://github.com/me/app"}'

# Trigger a deployment -> 202 { deploymentId }
curl -X POST https://gheima.ma/api/v1/services/<id>/deploy \
  -H "Authorization: Bearer gh_xxxxx"

Les endpoints de liste sont paginés par curseur : passez ?limit= (1–100) et ?cursor=, et lisez le curseur suivant dans pagination.nextCursor de la réponse.

✦ Tout langage capable d’une requête HTTP peut piloter Gheima.