Gestionar un servidor dedicado con la API de Hostbrid

La API de dedicados permite consultar ofertas, calcular una estimación mensual, preparar una cotización y seguir un servidor contratado. Sirve para automatizar operaciones del ciclo de vida, pero no convierte el hardware en alquiler por horas ni reserva una máquina al consultar el stock. La disponibilidad y el plazo dependen de la oferta y de su estado.

Si todavía estás comparando configuraciones, revisa primero qué comprobar antes de elegir un servidor dedicado: CPU, memoria, discos, red, plazo y coste final.

Antes de preparar un pedido

Usa la referencia pública OpenAPI para confirmar el esquema vigente y los permisos de cada paso. La clave debe tener el permiso requerido; no pidas más permisos para evitar leer la documentación. El catálogo y los cálculos de lectura usan maquinas:leer. Emitir una cotización y preparar el pedido necesitan facturacion:pedir.

1. Consulta oferta, configuración y precio

El flujo empieza con estas operaciones:

1. GET /api/dedicated/v1/catalog/ consulta modelos, stock estimado y precios.
2. POST /api/dedicated/v1/options/ consulta las opciones disponibles para una oferta.
3. POST /api/dedicated/v1/estimates/ calcula el precio mensual de una configuración.

Las dos operaciones POST de opciones y estimación calculan o consultan datos: no compran ni reservan hardware. Una estimación tampoco sustituye el precio exacto de la cotización temporal. Revisa en OpenAPI los campos requeridos y manda solo opciones que la oferta actual admita.

2. Prepara la cotización y el pago

Cuando la configuración esté clara, POST /api/dedicated/v1/quotes/ emite una cotización temporal para esa cuenta. Después POST /api/dedicated/v1/orders/ prepara el pedido mensual y el enlace a Stripe Checkout, con el contrato aceptado y la instalación elegida. POST /api/dedicated/v1/orders/{order_id}/checkout/ recupera el enlace vigente si necesitas volver a abrirlo.

Estas llamadas no sustituyen la confirmación del cliente: el pago se completa en Checkout. Solo el pago confirmado autoriza la provisión automática. Comprueba la configuración, periodicidad, extras, precio, contrato y plazo que muestra el panel antes de pagar. La contratación es mensual, con un mínimo de un mes; cancelar o borrar después no prorratea ni devuelve el mes ya pagado.

3. Sigue la entrega y la instalación

Consulta GET /api/dedicated/v1/orders/{order_id}/ para ver el pedido y el identificador del servidor cuando exista. GET /api/dedicated/v1/servers/ y GET /api/dedicated/v1/servers/{server_id}/ muestran tus dedicados y los datos disponibles; la IP solo aparece cuando se ha verificado. GET /api/dedicated/v1/operations/{operation_id}/ permite seguir una operación sin volver a ejecutarla.

Para configurar la primera instalación, consulta GET /api/dedicated/v1/servers/{server_id}/installation/ y luego usa POST en esa ruta con un sistema admitido y una clave pública SSH. No envíes una clave privada. Configurar la primera instalación no es lo mismo que reinstalar un servidor que ya contiene datos.

4. Trata la reinstalación y la baja como acciones destructivas

Reinstalar requiere permiso dedicados:reinstalar: primero pide una vista previa a /reinstall-preview/, revisa qué discos se borrarán y confirma el paso siguiente con el token temporal. La baja también es de dos pasos: dedicados:cancelar, una vista previa en /terminate-preview/ y confirmación en /terminate/. Dar de baja evita renovaciones al final del periodo pagado; no borra hoy los discos, no cancela la mensualidad en curso y no genera devolución.

La consola documenta además reinicios (dedicados:reiniciar) y consola temporal cuando el hardware la admite (dedicados:consola). Los permisos se separan para que una clave de catálogo no pueda reinstalar o cancelar un servidor por accidente.

Comprueba el resultado

No deduzcas que un servidor está comprado porque aparezca en el catálogo ni que esté entregado porque un pedido tenga URL de Checkout. Sigue el estado del pedido y de la operación, y espera a que el panel verifique IP y capacidades. La API de Hostbrid resume las interfaces y permisos; la página de servidores dedicados muestra la oferta comercial actual.

Los endpoints, esquemas y permisos pueden cambiar: antes de ejecutar una operación real, vuelve a comprobarlos en la referencia API. Este artículo no da una garantía de stock, precio futuro ni plazo fijo de entrega.