Desarrolladores

API, línea de comandos y Terraform

Gestiona tus servidores, dominios, registros DNS y funciones desde código. Casi todo lo que haces en el panel también se puede hacer con la API REST usando una clave API personal.

1. Crea una clave API

Crea una clave en la página Claves API del panel. Una clave está vinculada a una sola cuenta y nunca tiene más permisos que tu rol en ella; puede ser de solo lectura, limitarse a productos concretos y tener fecha de caducidad. La clave completa se muestra una sola vez, al crearla.

Ir a las claves API →

2. Tu primera solicitud

Envía la clave en la cabecera Authorization:

curl -H "Authorization: Bearer hz_..." \
  https://api.haizora.com/v1/portal/servers

Lo que debes saber

Las claves de solo lectura solo pueden hacer solicitudes de lectura y se comportan como un rol de solo lectura en la cuenta.
Una clave de escritura funciona con el rol actual de quien la creó; si esa persona es quitada de la cuenta, la clave deja de ser válida de inmediato.
Con una clave no se pueden crear otras claves; las acciones de equipo e invitaciones solo se hacen desde el panel.
Las respuestas de error incluyen los campos error.code y error.message.
Cada clave puede hacer como máximo 300 solicitudes por minuto; si se supera, se devuelve 429 con una cabecera Retry-After.

Herramienta de línea de comandos: haizoraEn preparación para su publicación

Una herramienta de Node.js sin dependencias para iniciar sesión, listar servidores y acciones de encendido, registros DNS y publicación de funciones (Node 18 o superior).

haizora login                   # paste an hz_... token
haizora servers list
haizora servers power <id> reboot
haizora dns list example.com
haizora dns add example.com A www 203.0.113.10 --ttl 300
haizora workers deploy ./worker.js --name hello

Proveedor de TerraformEn preparación para su publicación

Recursos para servidores, bases de datos gestionadas, funciones sin servidor y registros DNS. Los recursos de servidor y base de datos generan pedidos; el servicio se aprovisiona una vez pagada la factura.

provider "haizora" {}   # HAIZORA_TOKEN

resource "haizora_dns_record" "www" {
  domain_id = data.haizora_domain.main.id
  type      = "A"
  name      = "www"
  value     = "203.0.113.10"
}

resource "haizora_function" "hello" {
  name = "hello"
  code = file("worker.js")
}

La herramienta de línea de comandos y el proveedor de Terraform aún no se han publicado en npm ni en Terraform Registry. Mientras tanto, puedes usar directamente la API REST.

Referencia de la API

Esta lista se genera a partir del documento OpenAPI 3.1. Puedes descargar el documento para generar un cliente con Postman, Insomnia u openapi-generator.

Descargar openapi.json

Cargando la documentación de la API…