Gestionar un servidor dedicat amb l’API de Hostbrid

L’API de dedicats permet consultar ofertes, calcular una estimació mensual, preparar un pressupost i seguir un servidor contractat. Serveix per automatitzar operacions del cicle de vida, però no converteix el maquinari en lloguer per hores ni reserva una màquina en consultar l’estoc. La disponibilitat i el termini depenen de l’oferta i del seu estat.

Si encara compares configuracions, consulta primer què cal comprovar abans de triar un servidor dedicat: CPU, memòria, discos, xarxa, termini i cost total.

Abans de preparar una comanda

Fes servir la referència pública OpenAPI per confirmar l’esquema actual i els permisos de cada pas. La clau ha de tenir el permís requerit; no en demanis més per evitar llegir la documentació. El catàleg i els càlculs fan servir maquinas:leer. Emetre un pressupost i preparar una comanda requereix facturacion:pedir.

1. Consulta l’oferta, la configuració i el preu

El flux comença amb aquestes operacions:

1. GET /api/dedicated/v1/catalog/ consulta models, estoc estimat i preus.
2. POST /api/dedicated/v1/options/ consulta les opcions disponibles per a una oferta.
3. POST /api/dedicated/v1/estimates/ calcula el preu mensual d’una configuració.

Les dues operacions POST d’opcions i estimació consulten o calculen dades: no compren ni reserven maquinari. Una estimació tampoc substitueix el preu exacte del pressupost temporal. Revisa els camps requerits a OpenAPI i envia només opcions admeses per l’oferta actual.

2. Prepara el pressupost i el pagament

Quan la configuració estigui clara, POST /api/dedicated/v1/quotes/ emet un pressupost temporal per al compte. Després POST /api/dedicated/v1/orders/ prepara la comanda mensual i l’enllaç de Stripe Checkout amb el contracte acceptat i la instal·lació triada. POST /api/dedicated/v1/orders/{order_id}/checkout/ recupera l’enllaç vigent si necessites tornar a obrir Checkout.

Aquestes crides no substitueixen la confirmació del client: el pagament es completa a Checkout. Només el pagament confirmat autoritza la provisió automàtica. Abans de pagar, revisa al tauler la configuració, la periodicitat, els extres, el preu, el contracte i el termini estimat. El lloguer és mensual, amb un mínim d’un mes; donar-lo de baixa després no prorrateja ni retorna el mes pagat.

3. Segueix el lliurament i la instal·lació

Consulta GET /api/dedicated/v1/orders/{order_id}/ per veure la comanda i l’identificador del servidor quan existeixi. GET /api/dedicated/v1/servers/ i GET /api/dedicated/v1/servers/{server_id}/ mostren els teus dedicats i les dades disponibles; la IP només apareix quan s’ha verificat. GET /api/dedicated/v1/operations/{operation_id}/ permet seguir una operació sense tornar-la a executar.

Per configurar la primera instal·lació, consulta GET /api/dedicated/v1/servers/{server_id}/installation/ i després fes POST a la mateixa ruta amb un sistema admès i una clau pública SSH. No enviïs cap clau privada. Configurar la primera instal·lació no és el mateix que reinstal·lar un servidor que ja conté dades.

4. Tracta la reinstal·lació i la baixa com accions destructives

Reinstal·lar requereix dedicados:reinstalar: primer demana una vista prèvia a /reinstall-preview/, revisa quins discos s’esborraran i confirma el pas següent amb el testimoni temporal. La baixa també té dos passos: dedicados:cancelar, una vista prèvia a /terminate-preview/ i confirmació a /terminate/. Donar-lo de baixa evita renovacions al final del període pagat; no esborra els discos avui, no cancel·la el mes en curs ni genera una devolució.

La referència també documenta reinicis (dedicados:reiniciar) i una consola remota temporal quan el maquinari l’admet (dedicados:consola). Els permisos es separen perquè una clau de catàleg no pugui reinstal·lar o donar de baixa un servidor per error.

Comprova el resultat

No dedueixis que un servidor està comprat perquè aparegui al catàleg ni que estigui lliurat perquè una comanda tingui URL de Checkout. Segueix l’estat de la comanda i de l’operació, i espera que el tauler verifiqui la IP i les capacitats. La pàgina d’API de Hostbrid resumeix les interfícies i permisos; la pàgina de servidors dedicats mostra l’oferta comercial actual.

Els endpoints, esquemes i permisos poden canviar: torna’ls a comprovar a la referència API abans d’executar una operació real. Aquest article no garanteix estoc, preus futurs ni un termini fix de lliurament.