Entwickler

API, Kommandozeile und Terraform

Verwalten Sie Ihre Server, Domains, DNS-Einträge und Funktionen per Code. Das Meiste, was Sie im Panel tun können, geht auch über die REST API mit einem persönlichen API-Schlüssel.

1. API-Schlüssel erstellen

Erstellen Sie im Panel auf der Seite API-Schlüssel einen Schlüssel. Ein Schlüssel ist an ein einzelnes Konto gebunden und hat nie mehr Rechte als Ihre Rolle in diesem Konto; er kann auf Nur-Lesen gesetzt, auf bestimmte Produkte beschränkt und mit einem Ablaufdatum versehen werden. Der vollständige Schlüssel wird nur einmal angezeigt, nämlich bei der Erstellung.

Zu den API-Schlüsseln →

2. Ihre erste Anfrage

Senden Sie den Schlüssel im Authorization-Header:

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

Das sollten Sie wissen

Nur-Lesen-Schlüssel können ausschließlich Leseanfragen stellen und verhalten sich im Konto wie eine Nur-Lesen-Rolle.
Ein Schreibschlüssel arbeitet mit der aktuellen Rolle des Erstellers; wird die Person aus dem Konto entfernt, wird der Schlüssel sofort ungültig.
Mit einem Schlüssel lassen sich keine weiteren Schlüssel erstellen; Team- und Einladungsaktionen sind nur im Panel möglich.
Fehlerantworten enthalten die Felder error.code und error.message.
Pro Schlüssel sind höchstens 300 Anfragen pro Minute möglich; bei Überschreitung wird 429 mit einem Retry-After-Header zurückgegeben.

Kommandozeilen-Tool: haizoraVeröffentlichung in Vorbereitung

Ein abhängigkeitsfreies Node.js-Tool für Anmeldung, Serverlisten und Power-Aktionen, DNS-Einträge und das Veröffentlichen von Funktionen (Node 18 und höher).

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-ProviderVeröffentlichung in Vorbereitung

Ressourcen für Server, verwaltete Datenbanken, serverlose Funktionen und DNS-Einträge. Server- und Datenbankressourcen erzeugen Bestellungen; der Dienst wird bereitgestellt, nachdem die Rechnung bezahlt wurde.

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

Das Kommandozeilen-Tool und der Terraform-Provider sind noch nicht auf npm und in der Terraform Registry veröffentlicht. Bis dahin können Sie die REST API direkt verwenden.

API-Referenz

Diese Liste wird aus dem OpenAPI 3.1-Dokument erzeugt. Sie können das Dokument herunterladen, um mit Postman, Insomnia oder openapi-generator einen Client zu erzeugen.

openapi.json herunterladen

API-Dokumentation wird geladen…