Programiści

API, wiersz poleceń i Terraform

Zarządzaj serwerami, domenami, rekordami DNS i funkcjami z poziomu kodu. Większość działań z panelu można wykonać także przez REST API za pomocą osobistego klucza API.

1. Utwórz klucz API

W panelu utwórz klucz na stronie Klucze API. Klucz jest powiązany z jednym kontem i nie ma większych uprawnień niż Twoja rola na tym koncie; może być tylko do odczytu, ograniczony do wybranych produktów i mieć datę wygaśnięcia. Pełny klucz jest wyświetlany tylko raz, podczas tworzenia.

Przejdź do kluczy API →

2. Twoje pierwsze żądanie

Prześlij klucz w nagłówku Authorization:

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

Warto wiedzieć

Klucze tylko do odczytu mogą wysyłać wyłącznie żądania odczytu i na koncie działają jak rola tylko do odczytu.
Klucz do zapisu działa z aktualną rolą osoby, która go utworzyła; jeśli ta osoba zostanie usunięta z konta, klucz natychmiast przestaje obowiązywać.
Za pomocą klucza nie można utworzyć innego klucza; działania dotyczące zespołu i zaproszeń są dostępne wyłącznie w panelu.
Odpowiedzi z błędem zawierają pola error.code i error.message.
Dla każdego klucza można wysłać maksymalnie 300 żądań na minutę; po przekroczeniu limitu zwracany jest kod 429 z nagłówkiem Retry-After.

Narzędzie wiersza poleceń: haizoraW przygotowaniu do wydania

Narzędzie Node.js bez zależności (Node 18 lub nowszy) do logowania, wyświetlania serwerów i zarządzania ich zasilaniem, rekordów DNS oraz publikowania funkcji.

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

Dostawca TerraformW przygotowaniu do wydania

Zasoby serwera, zarządzanej bazy danych, funkcji bezserwerowej i rekordu DNS. Zasoby serwera i bazy danych tworzą zamówienie; usługa jest przygotowywana po opłaceniu faktury.

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

Narzędzie wiersza poleceń i dostawca Terraform nie zostały jeszcze opublikowane w npm ani w Terraform Registry. Do tego czasu możesz korzystać bezpośrednio z REST API.

Dokumentacja API

Ta lista jest generowana z dokumentu OpenAPI 3.1. Możesz pobrać dokument, aby wygenerować klientów za pomocą Postman, Insomnia lub openapi-generator.

Pobierz openapi.json

Ładowanie dokumentacji API…