API प्रमाणीकरण
Bearer API कुंजियों, सीमित अनुमतियों, केवल एक बार दिखने वाले सीक्रेट, निरस्तीकरण और बदलाव के साथ Rivya API अनुरोध प्रमाणित करें।
अंतिम समीक्षा 2026/05/10 को
Rivya API सर्वर-से-सर्वर पहुंच के लिए API कुंजियों का इस्तेमाल करता है।
API कुंजी ब्राउज़र लॉगिन सत्र जैसी चीज नहीं है। सार्वजनिक API प्रमाण-पत्र के रूप में कुकी, Better Auth सत्र स्थिति या निजी ब्राउज़र टोकन इस्तेमाल न करें।
हेडर का प्रारूप
कुंजी को Authorization हेडर में भेजें:
Authorization: Bearer rvya_sk_...पूरी कुंजी केवल बनाते समय एक बार दिखाई जाती है। Rivya पूरा सीक्रेट नहीं, बल्कि हैश और दिखाई देने वाला उपसर्ग संग्रहीत करता है।
कुंजी बनाएं
Rivya में साइन इन करें।
API कुंजी सेटिंग खोलें।
जरूरी अनुमतियों के साथ कुंजी बनाएं।
पूरी कुंजी तुरंत कॉपी करें।
इसे सर्वर-पक्ष के सीक्रेट प्रबंधक या परिवेश चर में सुरक्षित रखें।
कुंजी को क्लाइंट-पक्ष JavaScript, मोबाइल ऐप बंडल, सार्वजनिक कोड भंडार, विश्लेषण घटनाओं या लॉग में न रखें।
मौजूदा अनुमतियां
पहला संस्करण इन अनुमतियों का विवरण देता है:
models:readgenerations:creategenerations:readfiles:createfiles:readcredits:readwebhooks:managechat:createchat:read
सेटिंग में बनाई गई नई कुंजियों में दर्ज अनुमतियां सामान्य रूप से शामिल रहती हैं। Files API, API Webhooks या Chat API इस्तेमाल करने से पहले पुरानी कुंजियां दोबारा बनानी पड़ सकती हैं।
कुंजी रद्द करें या बदलें
अगर कोई कुंजी उजागर हो जाए:
सेटिंग से पुरानी कुंजी रद्द करें।
नई कुंजी बनाएं।
अपने सर्वर-पक्ष के गुप्त मान को अपडेट करें।
पुष्टि करें कि नई कुंजी
GET /api/v1/creditsके साथ काम करती है।बिल्ड सिस्टम, लॉग और डिप्लॉयमेंट वेरिएबल से पुरानी कुंजी हटाएं।
रद्द की गई कुंजियां api_key_revoked लौटाती हैं।
प्रमाणीकरण त्रुटियाँ
प्रमाणीकरण की सामान्य त्रुटियां:
api_key_missingapi_key_invalidapi_key_revokedapi_key_expiredapi_scope_deniedpublic_api_disabled
सार्वजनिक त्रुटियों की पूरी तालिका के लिए API त्रुटियाँ और सीमाएँ देखें।
