Aller au contenu

API de l'espace client

Se gère depuis : Espace client. 7 réponses, mises à jour le 21/11/2026.

Référence de l'API : toutes les routes, avec exemples curl

Questions essentielles 2

Que peut-on faire avec l'API de l'espace client ?

Piloter vos services depuis vos propres outils : un tableau de bord interne, un script, votre supervision ou votre chaîne de déploiement. L'API liste vos services, lit leur état et leurs adresses IP, démarre, redémarre ou arrête un serveur, réinstalle un VPS ou un serveur dédié, rend vos factures et commande des serveurs de jeu ou des VPS payés avec votre solde.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Créez une clé dans Espace clientMon ProfilSécuritéClés d'API, avec seulement les droits dont votre outil a besoin.

  2. Vérifiez-la avec un premier appel (voir la question « Comment faire un premier appel à l'API ? »).

  3. Branchez votre outil en suivant la référence de l'API : chaque route y a son exemple curl et sa réponse.

La référence complète de l'API : panel.helloserv.fr/api/docs/fr

Puis-je revendre des serveurs commandés par l'API ?

Oui. Votre outil commande des serveurs de jeu ou des VPS avec le solde de votre compte, au même prix que dans l'espace client, puis les gère par l'API pour vos propres clients. Vous fixez vos tarifs.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Créez une clé réservée à votre boutique, avec les droits Commande et Alimentation, limitée aux adresses IP de votre serveur.

  2. Quand un client achète chez vous, votre outil passe la commande, puis lui transmet l'adresse IP et l'état du serveur lus par l'API.

  3. Gardez votre solde alimenté : une commande que le solde ne couvre pas est refusée, et rien n'est créé.

Tutoriels 5

Comment créer une clé d'API ?

Une clé se crée dans votre espace client, une fois la double authentification activée sur votre compte. Elle n'est affichée qu'une fois : copiez-la tout de suite et gardez-la secrète, comme un mot de passe.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Activez la double authentification sur votre compte (application de codes ou passkey) : elle est demandée pour créer une clé.

  2. Espace clientMon ProfilSécurité, bouton Clés d'API (aussi dans le menu de votre compte, en haut à droite).

  3. Donnez un nom à la clé, cochez seulement les droits utiles (Lecture toujours, Alimentation, Réinstallation, Commande), indiquez si vous le voulez les adresses IP autorisées, puis Créer la clé et confirmez votre identité.

  4. Copiez la clé tout de suite : elle ne sera plus jamais affichée. Envoyez-la dans l'en-tête Authorization: Bearer de chaque requête.

Erreurs fréquentes

  • Clé perdue ou publiée par erreur : révoquez-la sur la même page, elle est refusée aussitôt, puis créez-en une autre.
  • Clé refusée (401) après une réinitialisation du mot de passe : par sécurité, les clés créées dans les 7 jours précédents sont révoquées avec les autres ajouts récents du compte. Créez-en une nouvelle.
  • Erreur 403 insufficient_scope : la clé n'a pas le droit demandé (Alimentation, Réinstallation ou Commande). Créez une clé avec ce droit.
  • Erreur 403 ip_not_allowed : l'appel vient d'une adresse absente de la liste de la clé. Ajoutez-la avec Modifier les adresses autorisées, sous la clé.
  • Erreur 429 : 120 requêtes par minute et par clé au plus, 6 actions par minute sur un même service, 10 commandes par jour et par clé.

La documentation complète, avec des exemples curl : panel.helloserv.fr/api/docs/fr

Comment faire un premier appel à l'API ?

L'API répond à l'adresse https://panel.helloserv.fr/api/v1, en JSON. Envoyez votre clé dans l'en-tête Authorization de chaque requête.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Dans un terminal, gardez la clé dans une variable, puis appelez la route account : elle rend votre compte, votre solde et les droits de la clé.

    terminal
    export HELLOSERV_KEY="hsk_votre_cle"curl https://panel.helloserv.fr/api/v1/account \  -H "Authorization: Bearer $HELLOSERV_KEY"
  2. Listez vos services en cours : chacun arrive avec son numéro, son type et son état.

    terminal
    curl "https://panel.helloserv.fr/api/v1/services?status=active" \  -H "Authorization: Bearer $HELLOSERV_KEY"
  3. Redémarrez un serveur avec son numéro (clé avec le droit Alimentation).

    terminal
    curl -X POST https://panel.helloserv.fr/api/v1/services/1234/power \  -H "Authorization: Bearer $HELLOSERV_KEY" -H "Content-Type: application/json" \  -d '{"action": "restart"}'

Erreurs fréquentes

  • Erreur 401 missing_key ou invalid_key : l'en-tête est absent, la clé est mal copiée ou elle a été révoquée.
  • Erreur 404 service_not_found : le numéro ne correspond à aucun service de votre compte.
Comment limiter une clé d'API à certaines adresses IP ?

Donnez à la clé la liste des adresses ou des plages d'où partent vos appels, 20 au plus, en IPv4 ou en IPv6. Un appel venu d'ailleurs est refusé, même avec la bonne clé.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Espace clientMon ProfilSécuritéClés d'API.

  2. À la création d'une clé, remplissez Adresses IP autorisées : une adresse ou une plage par ligne, par exemple 203.0.113.10 ou 2001:db8::/48. Votre adresse actuelle est rappelée sous le champ.

  3. Pour une clé existante : Modifier les adresses autorisées, sous la clé, puis Enregistrer. Votre identité est redemandée.

Erreurs fréquentes

  • Erreur 403 ip_not_allowed : l'appel vient d'une adresse absente de la liste. Il apparaît dans Derniers appels, sur la même page : ajoutez l'adresse si c'est bien la vôtre.
  • Un serveur qui sort aussi en IPv6 : ajoutez son adresse IPv6 en plus de l'IPv4.
Comment commander un serveur de jeu ou un VPS par l'API ?

Demandez d'abord le prix exact avec un essai à blanc, puis passez la commande. La facture est payée avec votre solde et le serveur est livré comme une commande faite dans l'espace client.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Créez une clé avec le droit Commande (jamais coché par défaut) et alimentez votre solde depuis l'espace client.

  2. Lisez le catalogue : GET /catalog donne les produits, GET /catalog/{type} leurs offres et leurs prix pour votre compte.

  3. Demandez le prix exact sans rien commander, avec "dry_run": true.

    terminal
    curl -X POST https://panel.helloserv.fr/api/v1/orders \  -H "Authorization: Bearer $HELLOSERV_KEY" -H "Content-Type: application/json" \  -d '{"type": "vpsintel", "offer_id": 3, "period": "monthly", "os": "debian12", "dry_run": true}'
  4. Passez la commande : même requête sans dry_run, avec un en-tête Idempotency-Key qui change à chaque commande. Si la requête part deux fois, la commande n'est passée qu'une fois.

  5. Suivez le service avec GET /services/{id} : il passe de pending à active une fois livré.

Erreurs fréquentes

  • Erreur 402 insufficient_balance : le solde ne couvre pas la commande, rien n'est commandé.
  • Erreur 422 country_required : renseignez votre pays dans votre profil, il fixe la TVA.
  • Erreur 429 order_limit_reached : 10 commandes par jour avec une même clé.
  • Erreur 400 unknown_field : un champ mal écrit est refusé, il ne devient jamais une commande.
Comment voir les appels d'une clé d'API et la révoquer ?

La page des clés montre la dernière utilisation de chaque clé et les derniers appels reçus, refus compris. Une clé révoquée est refusée aussitôt.

Dans l'espace client

Mon ProfilSécuritéClés d'APIOuvrir
  1. Espace clientMon ProfilSécuritéClés d'API.

  2. Sous chaque clé : sa date de création, sa dernière utilisation avec l'adresse IP d'origine et le nombre d'appels sur 24 h.

  3. Derniers appels, en bas de la page : les appels reçus avec vos clés, du plus récent au plus ancien.

  4. Pour couper une clé : Révoquer, sous la clé, puis confirmez. Les outils qui l'utilisent n'ont plus accès.

Pas trouvé ? Ouvrez un ticket depuis votre espace client. Conditions générales : helloserv.fr/fr/legal