Ir al contenido

-10 % en su primer mes-10 % 1er mes

¿Qué quiere alojar?

Gestione sus servidores desde sus propias herramientas

La API del área de cliente de HelloServ abre sus servidores de juegos, sus VPS y sus servidores dedicados a sus scripts, a su monitorización y a sus paneles: estado en directo, encendido y apagado, reinstalación, facturas y pedidos de servidores pagados con su saldo.

terminal

$ curl https://panel.helloserv.fr/api/v1/services \
    -H "Authorization: Bearer $HELLOSERV_KEY"

{"data": [
  {"id": 48213, "name": "vps-prod-1", "type": "vps",
   "product": "vpsryzen", "status": "active",
   "primary_ip": "203.0.113.24",
   "actions": {"power": true, "reinstall": true}},
  {"id": 31877, "name": "survie-mc", "type": "game",
   "product": "minecraft", "status": "active",
   "primary_ip": "198.51.100.7",
   "actions": {"power": true, "reinstall": false}}
]}

Las acciones del panel, desde su propio código

Una API REST en JSON, sobre HTTPS. Cada clave solo recibe los permisos que usted le da.

  • Listar sus servicios, sus características y sus direcciones IPGET /servicesLectura
  • Leer el estado de un servidor en directoGET /services/{id}/statusLectura
  • Encender, reiniciar o apagar un servidorPOST /services/{id}/powerEncendido
  • Reinstalar un VPS o un servidor dedicadoPOST /services/{id}/reinstallReinstalación
  • Descargar sus facturas en PDFGET /invoices/{number}/pdfLectura
  • Pedir un servidor de juegos o un VPS con su saldoPOST /ordersPedidos

La documentación describe también la cuenta y su saldo, el catálogo con sus precios, el historial de pedidos, los límites y los códigos de error.

Conecte la API a las herramientas que ya utiliza

Unas pocas líneas de script bastan para la mayoría de los usos. En los ejemplos, $API equivale a https://panel.helloserv.fr/api/v1 y $HELLOSERV_KEY contiene su clave.

Monitorización y paneles

Muestre el estado de sus servidores junto al resto de su infraestructura, en Grafana, Uptime Kuma o su herramienta interna, y lance una alerta cuando uno de ellos se detenga.

supervision.sh

$ curl -s $API/services/48213/status \
    -H "Authorization: Bearer $HELLOSERV_KEY" | jq .data.power
"running"

Scripts, tareas programadas y despliegues

Reinicie un servidor de juegos tras actualizar sus mods, reinstale un VPS de pruebas desde su integración continua o apague un servidor por la noche con una tarea programada.

deploy.yml

- name: Restart the server after the update
  run: >
    curl -X POST
    https://panel.helloserv.fr/api/v1/services/31877/power
    -H "Authorization: Bearer ${{ secrets.HELLOSERV_KEY }}"
    -H "Content-Type: application/json"
    -d '{"action": "restart"}'

Reventa de servidores de juegos y VPS

Su tienda pide el servidor con su saldo, al precio del área de cliente, y lo entrega a su cliente con su dirección IP. Usted fija sus propias tarifas.

commande.sh

$ curl -X POST $API/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-1042" \
    -H "Content-Type: application/json" \
    -d '{"type": "minecraft", "offer_id": 2, "period": "monthly"}'

Agencias y parques de servidores

Gestione los servidores de sus clientes desde su herramienta de explotación, con una clave por proyecto, y descargue cada mes las facturas en PDF para su contabilidad.

factures.sh

$ curl -s "$API/invoices?per_page=100" \
    -H "Authorization: Bearer $HELLOSERV_KEY"
$ curl -o INV-2026-001234.pdf \
    $API/invoices/INV-2026-001234/pdf \
    -H "Authorization: Bearer $HELLOSERV_KEY"

Una clave por herramienta, con sus permisos y sus direcciones

Las claves se crean en el área de cliente, en Mi perfil y luego Seguridad. La creación pide la autenticación en dos pasos, y cada clave se muestra una sola vez.

Formulario de creación de una clave de API en el área de cliente de HelloServ, con los permisos Lectura, Encendido, Reinstalación y Pedidos y el campo de direcciones IP autorizadas
Creación de una clave: un nombre, los permisos marcados uno a uno y las direcciones IP autorizadas.
Dos claves de API en el área de cliente con sus permisos, su último uso y sus direcciones IP autorizadas
Cada clave muestra sus permisos, su último uso y las direcciones desde las que se acepta.
Registro de las últimas llamadas a la API con la ruta, el código de respuesta, la clave y la dirección IP
Las últimas llamadas, rechazos incluidos: una llamada desde una dirección no autorizada se rechaza y aparece aquí.

Pida servidores con el saldo de su cuenta

Los precios, el IVA y la factura son los del área de cliente, y el servidor se entrega en 60 segundos.

  1. 01Recargue su saldo desde el área de cliente y cree una clave con el permiso Pedidos, que nunca viene marcado por defecto.
  2. 02Consulte el catálogo: las ofertas a la venta y sus precios para su cuenta, IVA incluido.
  3. 03Pida un presupuesto con dry_run: el precio exacto, sin pedir nada.
  4. 04Haga el pedido con una clave de idempotencia: enviado dos veces, solo se registra una vez.

terminal

$ curl -X POST https://panel.helloserv.fr/api/v1/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-7f3a9c21" \
    -H "Content-Type: application/json" \
    -d '{"type": "vpsintel", "offer_id": 3,
         "period": "monthly", "os": "debian12"}'

{"data": {
  "order": {"id": 42, "status": "paid"},
  "invoice": {"number": "INV-2026-001234", "status": "paid",
              "total": 9.60},
  "services": [{"id": 5678, "name": "vps-2", "status": "pending"}],
  "balance": 40.40
}}

Una documentación con un ejemplo para cada ruta

Cada ruta tiene su petición curl y su respuesta. El centro de ayuda explica paso a paso cómo crear una clave, limitarla a sus direcciones IP y hacer un primer pedido.

Documentación de la API de HelloServ abierta en la sección de pedidos

Preguntas sobre la API

Centro de ayuda Escríbanos

¿La API tiene coste adicional?
No. Forma parte del área de cliente y funciona con todos sus servicios.
¿Qué servicios se pueden gestionar?
Los servidores de juegos, los VPS y los servidores dedicados. El estado y el encendido funcionan para los tres; la reinstalación es para los VPS y los servidores dedicados.
¿Se puede pedir un servidor dedicado por la API?
Por ahora no: la API pide servidores de juegos y VPS. Un servidor dedicado se pide desde la web o el área de cliente.
¿Cómo proteger una clave?
Dele solo los permisos necesarios y limítela a las direcciones IP de sus servidores, 20 como máximo. Si se filtra, revóquela desde el área de cliente: se rechaza al instante.
¿Hay límites?
120 peticiones por minuto y por clave, y 10 pedidos al día con una misma clave. Por encima, la API responde con el código 429 y el tiempo de espera.

Su servidor funciona 60 segundos después del pago.

Elija su oferta y pague en línea: el servidor se instala solo.