API VPS, automatisation des serveurs cloud en JSON REST

Oui, l'API VPS est gratuite pour tous les membres. L'émission de clés API et les requêtes sont gratuites, et les serveurs et options créés avec l'API sont payés aux mêmes prix que ceux créés dans le panneau de contrôle. Tout membre ayant effectué son premier paiement peut créer une clé immédiatement sur la page des clés API.

Une fois que vous avez effectué votre premier paiement, la page des clés API (/api-key) s'ouvre et vous y créez des clés. Placez la clé dans l'en-tête Authorization de chaque requête en utilisant le schéma Bearer. La clé déverrouille tout votre compte, alors ne la commettez pas dans des dépôts de code ; gardez-la dans des variables d'environnement ou un gestionnaire de secrets.

Lire le catalogue (GET /catalog), lire la liste des serveurs et les informations d'un serveur (GET /servers, GET /servers/{id}), créer un serveur (POST /servers), l'allumer, l'éteindre et le redémarrer (start, stop, reboot), le renouveler d'un mois (renew) et le supprimer (DELETE /servers/{id}). Exemples de requêtes et format des réponses figurent dans la documentation API.

Jusqu'à 300 requêtes par minute avec une seule clé. Au-delà, un code d'état 429 et l'erreur rate_limited sont renvoyés : faites attendre un instant votre script avant de renvoyer. L'automatisation quotidienne, comme la vérification de la liste des serveurs et la gestion de l'alimentation, tient largement dans cette limite. Aucun frais selon le nombre de requêtes.

Lorsqu'une requête POST /servers réussit, le paiement pour la période de facturation choisie est traité et le serveur est créé. Le paiement pour un serveur qui échoue à être créé est renvoyé à votre crédit de compte.

La valeur root_password figure une seule fois dans la réponse de la requête de création. Enregistrez-la en lieu sûr dès réception. Elle reste aussi visible 7 jours dans le panneau, et en envoyant aussi le numéro d'une clé SSH, vous vous connectez directement par clé, sans mot de passe. La valeur ipv4 de la réponse permet de lancer aussitôt la connexion SSH : idéal pour l'enchaîner à vos scripts de déploiement.

Oui, en indiquant le numéro d'une clé SSH enregistrée dans la valeur ssh_key_id de la requête de création, cette clé est installée sur le nouveau serveur. L'enregistrement de la clé se fait une fois dans l'écran Clés SSH du panneau, et l'empreinte est affichée comme avec ssh-keygen pour identifier aussitôt la clé. Définissez le numéro une fois et réutilisez-le.

Tout langage ou outil capable d'envoyer des requêtes HTTP convient. Testez aussitôt avec curl, puis appelez la même adresse avec les mêmes en-têtes depuis requests en Python, fetch en Node.js, les étapes de script de GitLab CI ou les requêtes HTTP de Terraform. Toutes les réponses sont en JSON, faciles à lire.

Les erreurs reviennent avec un code d'état autre que 2xx et un JSON contenant une valeur error. Clé incorrecte : unauthorized ; valeur manquante : bad_request ; solde insuffisant : not_enough_balance ; requête incompatible avec l'état du serveur : wrong_state. Les causes étant séparées, votre programme traite chaque situation.

Oui, l'API et le panneau manipulent le même compte et les mêmes serveurs. Les serveurs créés par API apparaissent tels quels dans la liste du panneau, où vous pouvez réinstaller le système ou consulter le mot de passe. La limite de 10 serveurs par compte s'applique aux deux méthodes. Même en mélangeant opérations manuelles et automatisées, l'état et les échéances s'affichent toujours de façon identique.