API कुंजियाँ और पुष्टि

हर रिक्वेस्ट के साथ API कुंजी जाती है। कुंजियाँ किसी वर्कस्पेस की होती हैं और उसी का बैलेंस इस्तेमाल करती हैं; हर कुंजी के लिए अलग बजट, मॉडल और पतों की सीमाएँ तय की जा सकती हैं।

कुंजी भेजना

दोनों में से कोई भी हेडर हर एंडपॉइंट पर काम करता है:

Authorization: Bearer zr_live_your_key_here
# or, as Anthropic's SDKs send it:
x-api-key: zr_live_your_key_here

कुंजियाँ zr_live_ से शुरू होती हैं। पूरी कुंजी सिर्फ़ एक बार, बनाते समय दिखती है; हम केवल उसका हैश रखते हैं, इसलिए कोई भी (हम भी) उसे आपको दोबारा नहीं दिखा सकता। कुंजी खो गई? उसे रद्द करें और नई बनाएँ।

AI एजेंट कनेक्ट करना

कोई एजेंट (OpenClaw, Hermes, Manus, या आपका अपना) बिना किसी से कुंजी कॉपी करवाए अपनी कुंजी पा सकता है: वह लिंक माँगता है, उसका उपयोगकर्ता zurelay.com पर रोज़ाना की सीमा के साथ मंज़ूरी देता है, और एजेंट कुंजी ले लेता है। यह TV में साइन इन करने जैसा है (OAuth का डिवाइस फ़्लो, RFC 8628)। इन दो कॉल के लिए किसी कुंजी की ज़रूरत नहीं है।

curl -X POST https://api.zurelay.com/connect \
  -H "Content-Type: application/json" \
  -d '{"name": "OpenClaw"}'
{
  "status": "pending",
  "device_code": "zr_dc_…",
  "user_code": "WDJB-MJHT",
  "verification_uri": "https://zurelay.com/connect",
  "verification_uri_complete": "https://zurelay.com/connect?code=WDJB-MJHT",
  "expires_in": 900,
  "interval": 2
}

व्यक्ति को verification_uri_complete और कोड दिखाएँ। वे साइन इन करके जाँचते हैं कि कोड मेल खाता है, वर्कस्पेस और रोज़ की सीमा चुनते हैं, और 15 मिनट के भीतर मंज़ूरी देते हैं। device_code सिर्फ़ एजेंट के पास रखें: कुंजी पाने के लिए इसकी ज़रूरत होती है।

curl -X POST https://api.zurelay.com/connect/key \
  -H "Content-Type: application/json" \
  -d '{"device_code": "zr_dc_…"}'
{
  "status": "approved",
  "api_key": "zr_live_…",
  "key_name": "OpenClaw",
  "workspace": "Acme",
  "daily_limit_usd": 10,
  "base_url": "https://api.zurelay.com/v1"
}

कुंजियाँ सुरक्षित रखें

• कुंजियाँ सीक्रेट मैनेजर या एनवायरनमेंट वैरिएबल में रखें, कभी भी कोड या रिपॉज़िटरी में नहीं।
• अपने सर्वर से Zurelay को कॉल करें। ब्राउज़र या मोबाइल ऐप में रखी कुंजी को ऐप इस्तेमाल करने वाला कोई भी व्यक्ति पढ़ सकता है।
• हर ऐप या एनवायरनमेंट (जैसे, production और staging) के लिए अलग कुंजी इस्तेमाल करें, ताकि बाकी कुंजियों को बदले बिना आप किसी एक को रद्द कर सकें।
• हर कुंजी को सिर्फ़ उतनी ही अनुमति दें जितनी उसे चाहिए: बजट, वे मॉडल जिन्हें वह कॉल करती है, और वे पते जहाँ से उसका इस्तेमाल होता है। कुंजी की सीमाएँ और नियम देखें।
• अगर कोई कुंजी लीक हो जाए, तो उसे API कुंजियाँ में जाकर रद्द करें। उससे किए गए अनुरोध 15 सेकंड के भीतर बंद हो जाते हैं।

कुंजी पर लगाई जा सकने वाली सीमाएँ

पुष्टि करने में गड़बड़ियाँ