API وسطر الأوامر وTerraform

1. أنشئ مفتاح API

أنشئ مفتاحًا من صفحة مفاتيح API في اللوحة. المفتاح مرتبط بحساب واحد ولا يتجاوز صلاحيات دورك فيه؛ ويمكن جعله للقراءة فقط، وتقييده بمنتجات محددة، وتحديد تاريخ انتهاء له. يُعرض المفتاح كاملًا مرة واحدة فقط عند إنشائه.

2. طلبك الأول

أرسل المفتاح في ترويسة 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.