Dezvoltatori

API, linie de comandă și Terraform

Gestionați serverele, domeniile, înregistrările DNS și funcțiile direct din cod. Majoritatea acțiunilor din panou pot fi făcute și prin REST API, cu o cheie API personală.

1. Creați o cheie API

În panou, creați o cheie din pagina Chei API. Cheia este legată de un singur cont și nu are mai multe permisiuni decât rolul dvs. din acel cont; poate fi doar pentru citire, limitată la anumite produse și poate avea o dată de expirare. Cheia completă este afișată o singură dată, la creare.

Mergi la Chei API →

2. Prima dvs. cerere

Trimiteți cheia în antetul Authorization:

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

Ce trebuie să știți

Cheile doar pentru citire pot face numai cereri de citire și se comportă în cont ca rolul doar citire.
O cheie de scriere funcționează cu rolul pe care îl are în acel moment persoana care a creat-o; dacă persoana este eliminată din cont, cheia încetează imediat să mai fie valabilă.
Cu o cheie nu se poate crea altă cheie; acțiunile de echipă și de invitație se fac doar din panou.
Răspunsurile de eroare conțin câmpurile error.code și error.message.
Pentru fiecare cheie se pot trimite cel mult 300 cereri pe minut; la depășire se returnează 429 cu antetul Retry-After.

Instrument de linie de comandă: haizoraÎn pregătire pentru lansare

Un instrument Node.js fără dependențe (Node 18 sau mai nou) pentru autentificare, listarea serverelor și comenzi de alimentare, înregistrări DNS și publicarea funcțiilor.

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

Furnizor TerraformÎn pregătire pentru lansare

Resurse pentru server, bază de date gestionată, funcție serverless și înregistrare DNS. Resursele de server și de bază de date creează o comandă; serviciul este pregătit după ce factura este plătită.

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")
}

Instrumentul de linie de comandă și furnizorul Terraform nu au fost încă publicate în npm și în Terraform Registry. Până atunci, puteți folosi direct REST API.

Referință API

Această listă este generată din documentul OpenAPI 3.1. Puteți descărca documentul pentru a genera clienți cu Postman, Insomnia sau openapi-generator.

Descarcă openapi.json

Se încarcă documentația API…