Prise en main5 min de lecture

Automatiser avec l'API HorizonCloud

Pilotez vos serveurs par programmation : créer une clé, lister vos services, déclencher une action.

L'API REST HorizonCloud permet de gérer vos services depuis vos scripts, votre CI ou vos outils de monitoring. L'authentification se fait par clé API (jeton Bearer).

1. Créer une clé API

Depuis votre espace client : Profil → Clés API. Choisissez les permissions (scopes) puis créez la clé. Le jeton complet n'est affiché qu'une seule fois — copiez-le immédiatement.

Gérez et révoquez vos clés à tout moment.Mes clés API

2. Authentification

Ajoutez votre clé dans l'en-tête Authorization de chaque requête.

curl -H "Authorization: Bearer VOTRE_CLE" \
  https://horizon-cloud.fr/api/v1/services

Liste vos services (scope read)

3. Piloter un serveur

Avec le scope power, déclenchez une action : start, stop, shutdown ou reboot.

curl -X POST \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"action":"reboot"}' \
  https://horizon-cloud.fr/api/v1/services/SERVICE_ID/power

Sauvegardes (snapshots)

Avec le scope snapshot, créez un point de restauration — idéal pour automatiser une sauvegarde avant chaque déploiement.

curl -X POST \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"name":"avant-deploy"}' \
  https://horizon-cloud.fr/api/v1/services/SERVICE_ID/snapshots

Scopes & limites

read : compte, services et snapshots (lecture).
power : démarrer / arrêter / redémarrer.
snapshot : lister et créer des sauvegardes.
Limite : 120 requêtes par minute et par clé.
Une clé révoquée cesse immédiatement de fonctionner.