ऑथेंटिकेशन और API कुंजियाँ

कुंजी Authorization हेडर में भेजें

Authorization: Bearer YOUR_API_KEY

API सिर्फ़ इसी हेडर में कुंजी पढ़ता है.

• कुंजी कभी URL में न डालें (?api_key=…). URL लॉग में, ब्राउज़र हिस्ट्री में और शेयर किए गए लिंक में पहुँच जाते हैं. API ऐसी रिक्वेस्ट को 400 api_key_in_query के साथ मना कर देता है. उस कुंजी को लीक हुई मानें: उसे रिवोक करें और नई बनाएँ.
• ठीक https://gloriads.com/api/v1 को कॉल करें: किसी दूसरे पते पर रीडायरेक्ट फ़ॉलो करने वाला क्लाइंट रास्ते में आपकी कुंजी छोड़ देता है.
• API को स्प्रेडशीट, स्क्रिप्ट या सर्वर से कॉल करें, किसी वेब पेज के कोड से नहीं: पेज पर आने वाला कोई भी व्यक्ति कुंजी पढ़ सकता है.

कुंजी क्या कर सकती है

• हर एंडपॉइंट पर आपका अकाउंट पढ़ सकती है.
• कुछ नहीं बदल सकती. API सिर्फ़ पढ़ने के लिए है.
• आपके अकाउंट की सीमाएँ साझा करती है: आपकी सभी कुंजियाँ और कनेक्ट किए गए AI असिस्टेंट मिलकर गिने जाते हैं, इसलिए दूसरी कुंजी से आपको ज़्यादा रिक्वेस्ट नहीं मिलतीं. देखें सीमाएँ और एरर.

कुंजी बनाएँ

सेटिंग → API → कुंजी बनाएँ.

• नाम ज़्यादा से ज़्यादा 40 कैरेक्टर का हो सकता है. टूल का नाम इस्तेमाल करें, ताकि बाद में पता रहे कि कौन-सी कुंजी रिवोक करनी है.
• कुंजी एक बार दिखाई जाती है. हम उसका सिर्फ़ एक फ़िंगरप्रिंट रखते हैं, इसलिए उसे कोई दोबारा नहीं दिखा सकता — हम भी नहीं. इसे किसी पासवर्ड मैनेजर में या अपने टूल की सीक्रेट सेटिंग में रखें.
• आप एक समय में 10 कुंजियाँ रख सकते हैं.
• पब्लिक डेमो अकाउंट कुंजियाँ नहीं बना सकता.

कुंजियों की लिस्ट

हर कुंजी के साथ उसका नाम, उसके शुरू के कैरेक्टर (key_live_ab12…), वह कब बनी और आखिरी बार कब इस्तेमाल हुई, दिखता है.

“आखिरी इस्तेमाल” ज़्यादा से ज़्यादा घंटे में एक बार अपडेट होता है, इसलिए कुछ मिनट पहले इस्तेमाल हुई कुंजी पर अब भी पहले का समय दिख सकता है.

कुंजी रिवोक करें

कुंजी का ⋯ मेनू खोलें, फिर रिवोक करें.

यह तुरंत लागू होता है: उस कुंजी वाली अगली रिक्वेस्ट को 401 unauthorized मिलता है, वही जवाब जो कभी न बनी कुंजी को मिलता है. रिवोक की गई कुंजी वापस नहीं लाई जा सकती — नई कुंजी बनाएँ.

बिना कुंजी के कनेक्ट किए गए AI असिस्टेंट

claude.ai और ChatGPT कोई कुंजी इस्तेमाल नहीं करते: आप असिस्टेंट से Gloriads में साइन इन करते हैं और अनुमति दें पर क्लिक करते हैं. फिर असिस्टेंट को अपना अलग ऐक्सेस मिलता है, जो सिर्फ़ पढ़ सकता है. असिस्टेंट कैसे कनेक्ट करें: AI असिस्टेंट कनेक्ट करें.

• सेटिंग → API → कनेक्ट किए गए ऐप में हर असिस्टेंट दिखता है, साथ में वह पता जिसने ऐक्सेस माँगा, आपने उसे कब कनेक्ट किया और उसने आखिरी बार आपका अकाउंट कब पढ़ा (ज़्यादा से ज़्यादा घंटे में एक बार अपडेट होता है).
• किसी नाम के बगल में वेरिफ़ाइड नहीं का मतलब है कि ऐप ने अपना पता साबित किए बिना खुद को रजिस्टर किया. इसे तभी रखें जब आपने इसे खुद कनेक्ट किया हो.
• किसी असिस्टेंट को रोकने के लिए, उसका ⋯ मेनू खोलें, फिर डिस्कनेक्ट करें. यह तुरंत लागू होता है. उसे फिर से इस्तेमाल करने के लिए, असिस्टेंट से उसे दोबारा कनेक्ट करें.

जब कोई रिक्वेस्ट मना हो जाए

बाकी हर कोड के बारे में सीमाएँ और एरर में बताया गया है.

पब्लिक डेमो कुंजी

API रेफ़रेंस का Try it बटन एक पब्लिक कुंजी से पहले से भरा होता है. यह सिर्फ़ डेमो अकाउंट पढ़ती है, और इसकी सीमा 10 रिक्वेस्ट प्रति मिनट है, जो सभी विज़िटर में बँटी होती है. यह आपका अकाउंट नहीं पढ़ सकती: उसके लिए अपनी कुंजी इस्तेमाल करें.