Gérer un serveur dédié avec l’API Hostbrid

L’API dédiée permet de consulter les offres, d’estimer le prix mensuel, de préparer un devis et de suivre un serveur commandé. Elle automatise certaines opérations du cycle de vie, mais ne transforme pas le matériel en location à l’heure et ne réserve pas une machine lorsque vous consultez le stock. Disponibilité et délai dépendent de l’offre et de son état.

Si vous comparez encore les configurations, consultez d’abord les critères à vérifier avant de choisir un serveur dédié : CPU, mémoire, disques, réseau, délai et coût total.

Avant de préparer une commande

Consultez la référence publique OpenAPI pour vérifier les schémas et permissions actuels. Votre clé doit avoir l’autorisation requise ; ne demandez pas de permissions supplémentaires pour éviter de lire la documentation. Catalogue et estimations utilisent maquinas:leer. L’émission d’un devis et la préparation d’une commande nécessitent facturacion:pedir.

1. Consultez l’offre, la configuration et le prix

Le flux commence par ces opérations :

1. GET /api/dedicated/v1/catalog/ consulte les modèles, le stock estimé et les prix.
2. POST /api/dedicated/v1/options/ consulte les options disponibles pour une offre.
3. POST /api/dedicated/v1/estimates/ calcule le prix mensuel d’une configuration.

Les deux opérations POST d’options et d’estimation consultent ou calculent des données : elles n’achètent ni ne réservent de matériel. Une estimation ne remplace pas le prix exact du devis temporaire. Vérifiez dans OpenAPI les champs attendus et n’envoyez que des options prises en charge par l’offre actuelle.

2. Préparez le devis et le paiement

Lorsque la configuration est claire, POST /api/dedicated/v1/quotes/ émet un devis temporaire lié au compte. Puis POST /api/dedicated/v1/orders/ prépare la commande mensuelle et un lien Stripe Checkout, avec le contrat accepté et l’installation choisie. POST /api/dedicated/v1/orders/{order_id}/checkout/ récupère le lien en vigueur si vous devez rouvrir Checkout.

Ces appels ne remplacent pas la confirmation du client : le paiement se termine dans Checkout. Seul un paiement confirmé autorise le provisionnement automatique. Vérifiez dans le panneau la configuration, la période de facturation, les options, le prix, le contrat et le délai estimé avant de payer. La location est mensuelle, avec un minimum d’un mois ; une résiliation ultérieure ne prorata ni ne rembourse le mois déjà réglé.

3. Suivez la livraison et l’installation

Consultez GET /api/dedicated/v1/orders/{order_id}/ pour voir la commande et l’identifiant du serveur lorsqu’il existe. GET /api/dedicated/v1/servers/ et GET /api/dedicated/v1/servers/{server_id}/ affichent vos dédiés et les détails disponibles ; l’adresse IP n’apparaît qu’après vérification. GET /api/dedicated/v1/operations/{operation_id}/ permet de suivre une opération sans la relancer.

Pour configurer la première installation, consultez GET /api/dedicated/v1/servers/{server_id}/installation/, puis envoyez POST à cette route avec un système pris en charge et une clé publique SSH. N’envoyez jamais de clé privée. Une première installation est différente de la réinstallation d’un serveur qui contient déjà des données.

4. Traitez réinstallation et résiliation comme des actions destructives

La réinstallation nécessite dedicados:reinstalar : demandez d’abord un aperçu sur /reinstall-preview/, vérifiez quels disques seront effacés, puis confirmez l’étape suivante avec son jeton temporaire. La résiliation se fait également en deux étapes : permission dedicados:cancelar, aperçu sur /terminate-preview/, puis confirmation sur /terminate/. Elle arrête les renouvellements à la fin de la période payée ; elle n’efface pas les disques aujourd’hui, n’annule pas le mois en cours et ne déclenche pas de remboursement.

La référence documente également les redémarrages (dedicados:reiniciar) et une console distante temporaire lorsque le matériel le permet (dedicados:consola). Les permissions sont distinctes pour éviter qu’une clé limitée au catalogue puisse réinstaller ou résilier un serveur par erreur.

Vérifiez le résultat

Ne déduisez pas qu’un serveur est acheté parce qu’il apparaît au catalogue, ni qu’il est livré parce qu’une commande a une URL Checkout. Suivez la commande et l’opération, puis attendez que le panneau vérifie l’adresse IP et les capacités. La page API Hostbrid résume les interfaces et les permissions ; la page des serveurs dédiés présente l’offre commerciale actuelle.

Les endpoints, schémas et permissions peuvent changer : vérifiez-les dans la référence API avant toute opération réelle. Cet article ne garantit ni stock, ni prix futur, ni délai fixe de livraison.