Aller au contenu

-10 % sur votre premier mois-10 % 1er mois

Que voulez-vous héberger ?

Pilotez vos serveurs depuis vos propres outils

L'API de l'espace client HelloServ ouvre vos serveurs de jeu, vos VPS et vos serveurs dédiés à vos scripts, à votre supervision et à vos tableaux de bord : état en direct, démarrage et arrêt, réinstallation, factures et commande de serveurs payés avec votre solde.

terminal

$ curl https://panel.helloserv.fr/api/v1/services \
    -H "Authorization: Bearer $HELLOSERV_KEY"

{"data": [
  {"id": 48213, "name": "vps-prod-1", "type": "vps",
   "product": "vpsryzen", "status": "active",
   "primary_ip": "203.0.113.24",
   "actions": {"power": true, "reinstall": true}},
  {"id": 31877, "name": "survie-mc", "type": "game",
   "product": "minecraft", "status": "active",
   "primary_ip": "198.51.100.7",
   "actions": {"power": true, "reinstall": false}}
]}

Les actions du panel, depuis votre propre code

Une API REST en JSON, sur HTTPS. Chaque clé ne reçoit que les droits que vous lui donnez.

  • Lister vos services, leurs caractéristiques et leurs adresses IPGET /servicesLecture
  • Lire l'état d'un serveur en directGET /services/{id}/statusLecture
  • Démarrer, redémarrer ou arrêter un serveurPOST /services/{id}/powerAlimentation
  • Réinstaller un VPS ou un serveur dédiéPOST /services/{id}/reinstallRéinstallation
  • Récupérer vos factures en PDFGET /invoices/{number}/pdfLecture
  • Commander un serveur de jeu ou un VPS avec votre soldePOST /ordersCommande

La documentation décrit aussi le compte et son solde, le catalogue avec vos prix, l'historique des commandes, les limites et les codes d'erreur.

Branchez l'API sur les outils que vous utilisez déjà

Quelques lignes de script suffisent pour la plupart des usages. Dans les exemples, $API vaut https://panel.helloserv.fr/api/v1 et $HELLOSERV_KEY contient votre clé.

Supervision et tableaux de bord

Affichez l'état de vos serveurs à côté du reste de votre infrastructure, dans Grafana, Uptime Kuma ou votre outil maison, et déclenchez une alerte quand l'un d'eux s'arrête.

supervision.sh

$ curl -s $API/services/48213/status \
    -H "Authorization: Bearer $HELLOSERV_KEY" | jq .data.power
"running"

Scripts, tâches planifiées et déploiements

Redémarrez un serveur de jeu après une mise à jour de mods, réinstallez un VPS de test depuis votre chaîne d'intégration ou arrêtez un serveur la nuit avec une tâche planifiée.

deploy.yml

- name: Restart the server after the update
  run: >
    curl -X POST
    https://panel.helloserv.fr/api/v1/services/31877/power
    -H "Authorization: Bearer ${{ secrets.HELLOSERV_KEY }}"
    -H "Content-Type: application/json"
    -d '{"action": "restart"}'

Revente de serveurs de jeu et de VPS

Votre boutique commande le serveur avec votre solde, au prix de l'espace client, puis le remet à votre client avec son adresse IP. Vous fixez vos propres tarifs.

commande.sh

$ curl -X POST $API/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-1042" \
    -H "Content-Type: application/json" \
    -d '{"type": "minecraft", "offer_id": 2, "period": "monthly"}'

Agences et parcs de serveurs

Gérez les serveurs de vos clients depuis votre outil d'exploitation, avec une clé par projet, et récupérez chaque mois les factures en PDF pour votre comptabilité.

factures.sh

$ curl -s "$API/invoices?per_page=100" \
    -H "Authorization: Bearer $HELLOSERV_KEY"
$ curl -o INV-2026-001234.pdf \
    $API/invoices/INV-2026-001234/pdf \
    -H "Authorization: Bearer $HELLOSERV_KEY"

Une clé par outil, avec ses droits et ses adresses

Les clés se créent dans l'espace client, sous Mon Profil puis Sécurité. La double authentification est demandée à la création, et chaque clé n'est affichée qu'une fois.

Formulaire de création d'une clé d'API dans l'espace client HelloServ, avec les droits Lecture, Alimentation, Réinstallation et Commande et le champ des adresses IP autorisées
Création d'une clé : un nom, les droits cochés un par un et les adresses IP autorisées.
Deux clés d'API dans l'espace client avec leurs droits, leur dernière utilisation et leurs adresses IP autorisées
Chaque clé affiche ses droits, sa dernière utilisation et les adresses d'où elle est acceptée.
Journal des derniers appels à l'API avec la route, le code de réponse, la clé et l'adresse IP
Les derniers appels, refus compris : un appel venu d'une adresse non autorisée est rejeté et apparaît ici.

Commandez des serveurs avec le solde de votre compte

Les prix, la TVA et la facture sont ceux de l'espace client, et le serveur est livré en 60 secondes.

  1. 01Alimentez votre solde depuis l'espace client et créez une clé avec le droit Commande, qui n'est jamais coché par défaut.
  2. 02Lisez le catalogue : les offres en vente et leurs prix pour votre compte, TVA comprise.
  3. 03Demandez un devis avec dry_run : le prix exact, sans rien commander.
  4. 04Passez la commande avec une clé d'idempotence : envoyée deux fois, elle n'est passée qu'une fois.

terminal

$ curl -X POST https://panel.helloserv.fr/api/v1/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-7f3a9c21" \
    -H "Content-Type: application/json" \
    -d '{"type": "vpsintel", "offer_id": 3,
         "period": "monthly", "os": "debian12"}'

{"data": {
  "order": {"id": 42, "status": "paid"},
  "invoice": {"number": "INV-2026-001234", "status": "paid",
              "total": 9.60},
  "services": [{"id": 5678, "name": "vps-2", "status": "pending"}],
  "balance": 40.40
}}

Une documentation avec un exemple pour chaque route

Chaque route y a sa requête curl et sa réponse. Le centre d'aide explique pas à pas la création d'une clé, la limitation par adresses IP et la première commande.

Documentation de l'API HelloServ ouverte sur la section Commandes

Questions sur l'API

Centre d'aide Nous écrire

L'API est-elle payante ?
Non. Elle fait partie de l'espace client et fonctionne avec tous vos services.
Quels services peut-on piloter ?
Les serveurs de jeu, les VPS et les serveurs dédiés. L'état et l'alimentation fonctionnent pour les trois ; la réinstallation concerne les VPS et les serveurs dédiés.
Peut-on commander un serveur dédié par l'API ?
Pas pour l'instant : l'API commande les serveurs de jeu et les VPS. Un serveur dédié se commande depuis le site ou l'espace client.
Comment protéger une clé ?
Donnez-lui seulement les droits utiles et limitez-la aux adresses IP de vos serveurs, 20 au plus. Si elle fuite, révoquez-la depuis l'espace client : elle est refusée aussitôt.
Y a-t-il des limites ?
120 requêtes par minute et par clé, et 10 commandes par jour avec une même clé. Au-delà, l'API répond avec le code 429 et le délai à attendre.

Votre serveur tourne 60 secondes après le paiement.

Choisissez votre offre, payez en ligne : le serveur s'installe tout seul.