API CLIENT · V1 BÊTA
API REST pour
VPS et serveurs dédiés
Gérez vos serveurs depuis votre code : commandez et supprimez des VPS à l'heure, lancez des actions d'alimentation et des réinstallations, capturez et déployez vos propres images, et réglez vos factures avec votre crédit.
L'API client de X-ZoneServers (v1, bêta publique) expose 92 opérations via HTTPS, avec une spécification OpenAPI 3.0, des clés API à portée limitée et une limite par défaut de 1 000 requêtes par heure et par clé. Elle est incluse dans chaque compte, sans frais supplémentaires.
92 opérations d'API1 000 requêtes par heure et par clé
Votre premier appel
Créez une clé dans l'espace client, sous Profile → API Keys, puis demandez à l'API qui vous êtes.
curl https://my.x-zoneservers.com/api/v1/ \
-H "Authorization: Bearer $XZ_API_KEY"
{ "success": true,
"data": {
"version": "1",
"key": { "scopes": ["read", "services"] },
"rate_limit": { "limit": 1000, "remaining": 999 }
} }01Fonctionnalités
Ce que vous pouvez automatiser
L'API couvre tout le cycle de vie d'un serveur, de la commande à la facture, avec les mêmes autorisations que l'espace client.
Déploiement et suppression
Commandez un VPS en facturation horaire ou mensuelle, transmettez des user-data cloud-init et des clés SSH pour le premier démarrage, puis supprimez-le une fois le travail terminé. La facturation horaire s'arrête dès que le serveur n'existe plus.
Alimentation, réinstallation et statistiques
Démarrez, arrêtez, redémarrez et réinstallez vos VPS, réinitialisez les mots de passe root, et consultez les statistiques d'utilisation et de trafic depuis vos scripts de supervision.
Images personnalisées
Capturez un VPS sous forme d'image (jusqu'à 3 par compte), ou enregistrez votre propre image qcow2 ou raw (vérifiée par SHA-256) et déployez de nouveaux serveurs à partir de celle-ci.
Facturation et consommation
Consultez votre solde de crédit et les frais horaires du mois en cours, listez les factures et factures pro forma, et réglez-les avec votre crédit — utile pour les tableaux de bord de coûts et les alertes budgétaires.
Options et mises à niveau
Achetez des options pour un service existant, comme des adresses IP supplémentaires, ou passez-le à une offre supérieure sans ouvrir l'espace client.
Projets et clés à portée limitée
Regroupez vos serveurs en projets et générez des clés liées à un seul projet : une clé de staging ne pourra ainsi jamais voir ni toucher la production.
02Fonctionnement
Exemple : un VPS à l'heure pour un seul job CI
Créez une machine de build propre, exécutez le pipeline, supprimez-la — et payez les heures pendant lesquelles elle a existé.
Les services à l'heure sont débités du crédit de votre compte au lieu d'être facturés : conservez donc un solde sur le compte. Envoyez un en-tête Idempotency-Key avec chaque commande : une requête qui a expiré peut alors être renvoyée sans créer de second serveur.
1. Choisissez une offre : listez les produits avec leurs prix horaires et mensuels.
curl https://my.x-zoneservers.com/api/v1/products \
-H "Authorization: Bearer $XZ_API_KEY"2. Commandez le VPS en facturation horaire, avec un script de premier démarrage et votre clé SSH.
curl -X POST https://my.x-zoneservers.com/api/v1/orders \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Idempotency-Key: ci-run-4812" \
-H "Content-Type: application/json" \
-d '{"productId": "<plan-id>", "billingCycle": "hourly",
"hostname": "ci-4812.example.com", "location": "<location>",
"configOptions": {"os_image_id": "<image-id>",
"ssh_keys": ["ssh-ed25519 AAAA... ci@runner"],
"user_data": "#!/bin/sh\n/opt/ci/run-pipeline.sh"}}'3. Une fois le job terminé, supprimez le serveur. La facturation s'arrête immédiatement.
curl -X DELETE https://my.x-zoneservers.com/api/v1/vps/<vps-id> \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"immediate": true}'03API
Conçue pour les scripts et les agents IA
Quand c'est un programme, et non une personne, qui clique sur les boutons, un comportement prévisible compte davantage que le nombre d'endpoints.
Clés à portée limitée
Chaque clé ne dispose que des portées que vous lui accordez — read, services, orders, billing, destructive — et, en option, d'une liste d'IP autorisées et d'une date d'expiration.
Limites de débit publiées
1 000 requêtes par heure et par clé par défaut, indiquées dans les en-têtes X-RateLimit, avec de courts délais d'attente par serveur sur les actions d'alimentation et de réinstallation.
Relances sans risque
Les commandes acceptent un en-tête Idempotency-Key, et chaque refus renvoie un code d'erreur lisible par machine : l'automatisation peut ainsi distinguer un échec qu'il suffit de relancer d'un véritable échec.
Documentation lisible par machine
Une spécification OpenAPI 3.0 pour les générateurs de clients et un guide en Markdown brut que les assistants de code et les agents IA peuvent lire directement.
04Voir aussi
Vous revendez des serveurs à vos propres clients ?
Cette API client automatise votre propre compte. Pour revendre sous votre propre marque, rejoignez le programme revendeur et utilisez plutôt l'API revendeur : prix de gros avec paliers de volume, requêtes signées HMAC, webhooks, clés liées à un client et liens de console que vos clients ouvrent sans compte chez nous.
05Questions
FAQ API
Questions fréquentes sur l'automatisation de X-ZoneServers.
X-ZoneServers propose-t-il une API ?
Oui. L'API client (v1) est une API REST sur HTTPS, disponible à l'adresse https://my.x-zoneservers.com/api/v1, avec 92 opérations couvrant les VPS, les serveurs dédiés, les commandes, les options, les mises à niveau, les factures, les clés SSH et les images personnalisées. Elle est en bêta publique : assez stable pour bâtir dessus, mais les endpoints et la structure des réponses peuvent encore changer.
L'accès à l'API est-il gratuit ?
Oui. L'accès à l'API est inclus dans chaque compte, sans frais supplémentaires ; vous ne payez que les serveurs et les options que vous commandez, aux mêmes prix que sur le site web et dans l'espace client.
Puis-je créer et supprimer des VPS à l'heure via l'API ?
Oui. Passez une commande avec le cycle de facturation réglé sur « horaire », éventuellement avec des user-data cloud-init et des clés SSH, puis supprimez le VPS lorsque vous n'en avez plus besoin. Les services à l'heure sont débités du crédit du compte et cessent d'être facturés dès leur suppression.
L'API fonctionne-t-elle avec les serveurs dédiés ?
En partie. Pour les serveurs dédiés, l'API couvre la commande, les options, les factures et les détails du service. Le contrôle de l'alimentation, les réinstallations d'OS et les réinitialisations de mot de passe ne sont pas disponibles pour les serveurs dédiés, ni via l'API ni dans l'espace client.
Comment m'authentifier ?
Créez une clé API dans l'espace client, sous Profile → API Keys, et envoyez-la comme jeton Bearer. Choisissez ses portées lors de sa création et, si vous le souhaitez, limitez-la à certaines adresses IP ou donnez-lui une date d'expiration. Les clés ne sont affichées qu'une seule fois et peuvent être révoquées à tout moment depuis l'espace client.
Existe-t-il une spécification OpenAPI ou Swagger ?
Oui. La spécification OpenAPI 3.0 complète est publiée à l'adresse https://my.x-zoneservers.com/api/v1/openapi.json, à côté de la documentation mise en forme et d'un guide d'utilisation en Markdown.
Commencer
Créez votre première clé API
Connectez-vous à l'espace client, ouvrez Profile → API Keys et effectuez votre premier appel en moins d'une minute. Les questions sur l'API arrivent directement aux personnes qui développent la plateforme.