Geliştiriciler

API, komut satırı ve Terraform

Sunucularınızı, alan adlarınızı, DNS kayıtlarınızı ve fonksiyonlarınızı koddan yönetin. Paneldeki işlerin çoğu kişisel API anahtarıyla REST API'den de yapılabilir.

1. API anahtarı oluşturun

Panelde API Anahtarları sayfasından bir anahtar oluşturun. Anahtar tek bir hesaba bağlıdır ve o hesaptaki rolünüzden fazla yetki taşımaz; salt okunur yapılabilir, belirli ürünlerle sınırlanabilir ve bitiş tarihi verilebilir. Anahtarın tamamı yalnız oluşturulurken bir kez gösterilir.

API anahtarlarına git →

2. İlk isteğiniz

Anahtarı Authorization başlığında gönderin:

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

Bilmeniz gerekenler

Salt okunur anahtarlar yalnız okuma istekleri yapabilir ve hesapta salt okunur rol gibi davranır.
Yazma anahtarı, oluşturan kişinin o anki rolüyle çalışır; kişi hesaptan çıkarılırsa anahtar hemen geçersiz olur.
Anahtarla başka anahtar oluşturulamaz; ekip ve davet işlemleri yalnız panelden yapılır.
Hata yanıtları error.code ve error.message alanlarını taşır.
Her anahtar için dakikada en fazla 300 istek yapılabilir; aşılırsa 429 ve Retry-After başlığı döner.

Komut satırı aracı: haizora

Oturum açma, sunucu listeleme ve güç işlemleri, DNS kayıtları ve fonksiyon yayınlama için bağımlılıksız bir Node.js aracı (Node 18 ve üstü).

npmjs.com/package/@haizora/cli

npm i -g @haizora/cli            # Node.js 18+
haizora login                    # paste an hz_... token
haizora whoami

haizora servers list
haizora servers get <id>
haizora servers power <id> reboot   # start | shutdown | stop | reboot

haizora domains list
haizora dns list example.com
haizora dns add example.com A www 203.0.113.10 --ttl 300
haizora dns add example.com MX @ mail.example.com --priority 10
haizora dns rm  example.com A www 203.0.113.10

haizora workers list
haizora workers deploy ./hello.js
haizora workers deploy ./api.ts --name api --env MODE=prod
haizora workers rollback hello 3

haizora databases list
haizora cdn list
haizora cdn purge www.example.com
haizora monitors list

haizora api GET /portal/me       # any endpoint in the OpenAPI document

CI ortamında login yerine HAIZORA_TOKEN (isteğe bağlı HAIZORA_API_URL) ortam değişkenini verin. Liste komutlarına --json ekleyince ham JSON döner. Çıkış kodları: 0 başarılı, 1 hata, 2 bilinmeyen komut, 3 yetkisiz.

Terraform sağlayıcısı

Sunucu, yönetilen veritabanı, sunucusuz fonksiyon ve DNS kaydı kaynakları. Sunucu ve veritabanı kaynakları sipariş oluşturur; hizmet fatura ödendikten sonra hazırlanır.

Yazma anahtarı gerekir; sipariş vermek, fonksiyon silmek ve DNS düzenlemek hesapta sahip ya da yönetici rolü ister.

registry.terraform.io/providers/haizora/haizora

terraform {
  required_providers {
    haizora = { source = "haizora/haizora" }
  }
}

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

Kaynaklar

haizora_server — Bulut sunucu siparişi. Sunucu fatura ödendikten sonra hazırlanır; IP ve SSH bilgileri sonraki yenilemede dolar. Silmek aboneliği iptal eder (iade yok).

haizora_database — Yönetilen PostgreSQL, MySQL ya da Redis siparişi. İlk parola bilerek state'e yazılmaz.

haizora_function — Sunucusuz fonksiyon. Kod, dil ya da gizli değer değişince yeni sürüm yayınlanır; yalnız ortam değişkeni değişirse yerinde güncellenir.

haizora_dns_record — Alan adının DNS kaydı. Kayıtların API kimliği yok; her değişiklik kaydı yeniden oluşturur.

data.haizora_domain — Alan adı kimliğini adından bulur.

API başvurusu

Bu liste OpenAPI 3.1 belgesinden üretilir. Postman, Insomnia ya da openapi-generator ile istemci üretmek için belgeyi indirebilirsiniz.

openapi.json indir

Bağlantılar

API belgesi yükleniyor…