API de VPS: automatiza tus servidores en la nube con JSON REST

Sí, la API de VPS es gratuita para todos los miembros. Emitir claves API y realizar solicitudes es gratuito, y los servidores y opciones creados con la API se pagan a los mismos precios que los creados en el panel de control. Cualquier miembro que haya realizado su primer pago puede crear una clave de inmediato en la página de claves API.

Una vez que realices tu primer pago, se abre la página de claves API (/api-key) y allí creas las claves. Coloca la clave en el encabezado Authorization de cada solicitud utilizando el esquema Bearer. La clave desbloquea toda tu cuenta, así que no la comprometas en repositorios de código; guárdala en variables de entorno o en un almacén de secretos.

Puedes leer el catálogo (GET /catalog), leer la lista de servidores y la información de uno (GET /servers, GET /servers/{id}), crear servidores (POST /servers), encender, apagar y reiniciar (start, stop, reboot), renovar un mes (renew) y borrar (DELETE /servers/{id}). Los ejemplos de peticiones y formatos de respuesta están en la documentación de la API.

Con una clave haces hasta 300 peticiones por minuto. Si superas el límite, vuelve un código de estado 429 con el error rate_limited, así que haz que tu script espere un momento y vuelva a enviar. Las automatizaciones diarias, como consultar la lista de servidores o gestionar el encendido, funcionan con holgura dentro de este límite. No hay coste por número de peticiones.

Cuando una solicitud POST /servers tiene éxito, se procesa el pago por el período de facturación elegido y se crea el servidor. El pago por un servidor que no se crea se devuelve al crédito de tu cuenta.

La respuesta a la petición de creación de servidor trae una vez el valor root_password. Guárdala en un lugar seguro en cuanto recibas la respuesta. También puedes volver a verla en el panel durante 7 días, y si envías a la vez el número de clave SSH, entras directamente con la clave sin contraseña. Con el valor ipv4 de la respuesta puedes empezar al instante la conexión SSH, así que se integra bien con scripts de despliegue.

Sí, si en la petición de creación de servidor pones el número de una clave SSH registrada en el valor ssh_key_id, esa clave se instala en el nuevo servidor. Basta con registrar la clave una vez en la pantalla de claves SSH del panel, y la huella se muestra igual que en ssh-keygen, así que reconoces al instante cada clave. Fija el número de clave una vez y reutilízalo.

Con cualquier lenguaje o herramienta capaz de enviar peticiones HTTP. Pruébala al instante con curl, y llámala con la misma dirección y cabeceras desde requests de Python, fetch de Node.js, los pasos de script de GitLab CI o la función de peticiones HTTP de Terraform. Todas las respuestas son JSON, así que leer los resultados es fácil.

Los errores vuelven con un código de estado distinto de 2xx y un JSON con el valor error. Si la clave es incorrecta, unauthorized; si falta un valor, bad_request; si falta saldo, not_enough_balance; si la petición no cuadra con el estado del servidor, wrong_state: los motivos vienen separados, así que tu programa trata cada caso.

Sí, la API y el panel trabajan con la misma cuenta y los mismos servidores. Los servidores creados por API aparecen tal cual en la lista del panel, y desde el panel puedes reinstalar el sistema operativo o consultar la contraseña. El límite de 10 servidores por cuenta se aplica a ambos métodos. Aunque combines tareas manuales y desde código, el estado y las fechas de pago siempre se ven igual.