API، خط فرمان و Terraform

۱. کلید API بسازید

از صفحه کلیدهای API در پنل یک کلید بسازید. کلید به یک حساب وابسته است و از نقش شما در آن اختیار بیشتری ندارد؛ می‌توان آن را فقط‌خواندنی کرد، به محصولات مشخصی محدود کرد و برایش تاریخ انقضا تعیین کرد. کلید کامل فقط یک بار، هنگام ساخت، نمایش داده می‌شود.

۲. اولین درخواست شما

کلید را در هدر Authorization ارسال کنید:

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

نکاتی که باید بدانید

• کلیدهای فقط‌خواندنی فقط می‌توانند درخواست خواندن بفرستند و در حساب مانند نقش فقط خواندنی عمل می‌کنند.
• کلید نوشتن با نقش فعلی سازنده‌اش کار می‌کند؛ اگر آن فرد از حساب حذف شود، کلید بلافاصله بی‌اعتبار می‌شود.
• با یک کلید نمی‌توان کلید دیگری ساخت؛ کارهای مربوط به تیم و دعوت‌نامه فقط از پنل انجام می‌شود.
• پاسخ‌های خطا شامل فیلدهای error.code و error.message هستند.
• برای هر کلید حداکثر 300 درخواست در دقیقه مجاز است؛ در صورت عبور از این حد، پاسخ 429 همراه با هدر Retry-After برگردانده می‌شود.

ابزار خط فرمان: haizoraدر حال آماده‌سازی برای انتشار

ابزاری بدون وابستگی مبتنی بر Node.js (Node 18 و بالاتر) برای ورود، فهرست سرورها و عملیات روشن/خاموش، رکوردهای DNS و انتشار توابع.

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در حال آماده‌سازی برای انتشار

منابع سرور، پایگاه داده مدیریت‌شده، تابع بدون سرور و رکورد DNS. منابع سرور و پایگاه داده یک سفارش ایجاد می‌کنند؛ سرویس پس از پرداخت فاکتور آماده می‌شود.

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

ابزار خط فرمان و ارائه‌دهنده Terraform هنوز در npm و Terraform Registry منتشر نشده‌اند. تا آن زمان می‌توانید مستقیماً از REST API استفاده کنید.

مرجع API

این فهرست از سند OpenAPI 3.1 تولید می‌شود. برای ساخت کلاینت با Postman، Insomnia یا openapi-generator می‌توانید سند را دانلود کنید.