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रिलीज़ की तैयारी में

लॉगिन, सर्वर सूची और पावर कार्रवाइयों, DNS रिकॉर्ड और फ़ंक्शन प्रकाशन के लिए बिना निर्भरता वाला Node.js टूल (Node 18 और उससे ऊपर)।

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 से क्लाइंट बनाने के लिए आप दस्तावेज़ डाउनलोड कर सकते हैं।