API, opdrachtregel en Terraform

1. Maak een API-sleutel aan

Maak in het paneel een sleutel aan op de pagina API-sleutels. De sleutel is aan één account gekoppeld en heeft nooit meer rechten dan uw rol in dat account; hij kan alleen-lezen zijn, tot bepaalde producten beperkt worden en een einddatum krijgen. De volledige sleutel wordt slechts één keer getoond, bij het aanmaken.

2. Uw eerste verzoek

Stuur de sleutel mee in de Authorization-header:

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

Goed om te weten

• Alleen-lezen sleutels kunnen alleen leesverzoeken doen en gedragen zich in het account als de rol alleen lezen.
• Een schrijfsleutel werkt met de rol die de maker op dat moment heeft; als die persoon uit het account wordt verwijderd, vervalt de sleutel direct.
• Met een sleutel kunnen geen andere sleutels worden aangemaakt; team- en uitnodigingsacties kunnen alleen via het paneel.
• Foutresponses bevatten de velden error.code en error.message.
• Per sleutel zijn maximaal 300 verzoeken per minuut toegestaan; bij overschrijding volgt 429 met de Retry-After-header.

Opdrachtregeltool: haizoraIn voorbereiding

Een Node.js-tool zonder afhankelijkheden (Node 18 of hoger) voor inloggen, servers weergeven en aan-/uitzetten, DNS-records en het publiceren van functies.

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

Terraform-providerIn voorbereiding

Resources voor servers, beheerde databases, serverloze functies en DNS-records. Server- en databaseresources maken een bestelling aan; de dienst wordt ingericht nadat de factuur is betaald.

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

De opdrachtregeltool en de Terraform-provider zijn nog niet gepubliceerd op npm en in de Terraform Registry. Tot die tijd kunt u de REST API rechtstreeks gebruiken.

API-referentie

Deze lijst wordt gegenereerd uit het OpenAPI 3.1-document. U kunt het document downloaden om clients te genereren met Postman, Insomnia of openapi-generator.