API त्रुटियों और पुनः प्रयासों को संभालें
ShareAI प्रमाणीकरण, स्कोप, मॉडल-एक्सेस और उपलब्धता त्रुटियों का निदान करें बिना डुप्लिकेट लेखन या असुरक्षित रीफ्रेश पुनः प्रयास के।
इस पेज पर
प्रतिक्रिया को सफलता के रूप में पढ़ने से पहले हमेशा HTTP स्थिति का निरीक्षण करें। ShareAI सेवाएं विभिन्न त्रुटि एनवलप्स लौटा सकती हैं: इनफेरेंस प्रदान कर सकता है error.code, OAuth प्रदान करता है error और error_description, और कंसोल रूट्स लौटा सकते हैं code, message और data.status.
| स्थिति | सामान्य अर्थ | पुनर्प्राप्ति |
|---|---|---|
| 200 के साथ एक त्रुटि ऑब्जेक्ट | वर्तमान चैट एंडपॉइंट में कोई-डिवाइस उपलब्धता परिणाम। | error.code का निरीक्षण करें और इसे सहायक उत्तर के रूप में प्रस्तुत न करें। |
| 400 | अमान्य अनुरोध या OAuth ग्रांट। | बॉडी, पैरामीटर, कॉलबैक या समाप्त/उपभोग किए गए कोड को सही करें। |
| 401 | गुम, समाप्त या अमान्य प्रमाणीकरण। | क्रेडेंशियल जांचें; केवल वैध OAuth ग्रांट को रिफ्रेश करें। |
| 402 | अपर्याप्त क्रेडिट या लागू शेष राशि। | पुनः प्रयास करने से पहले चयनित खाता शेष राशि जांचें। |
| 403 | स्कोप, स्वामित्व, भूमिका या सक्षम-स्थिति अस्वीकृति। | प्रलेखित अनुमति सीमा की जांच करें। |
| 404 | अज्ञात संसाधन या असमर्थित गेटवे मार्ग। | होस्ट, पथ और संसाधन पहचानकर्ताओं की जांच करें। |
| 409 | स्थिति या संशोधन संघर्ष। | वर्तमान स्थिति पढ़ें और परिवर्तन पर पुनर्विचार करें। |
| 429 | अनुरोध या समवर्तीता सीमा। | Retry-After का सम्मान करें और सीमित बैकऑफ का उपयोग करें। |
| 500 / 502 / 503 | सर्वर या अपस्ट्रीम उपलब्धता विफलता। | पुनः प्रयास सीमित रखें; डायग्नोस्टिक पहचानकर्ताओं को संरक्षित करें। |
एक सीमा के साथ पढ़ने का पुनः प्रयास करें#
पढ़ने में अस्थायी विफलताओं के लिए, बढ़ती देरी और जिटर के साथ प्रतीक्षा करें, Retry-After का सम्मान करें जब मौजूद हो और परिभाषित प्रयास या समय सीमा के बाद रुकें। जब डेटा अनुपलब्ध हो तो उपयोगकर्ता को दिखाएं, चुपचाप लूप न करें।
लेखन को सावधानीपूर्वक संभालें#
मूल्य निर्धारण अपडेट, मॉडल निर्माण या साझा करने के आदेश को स्वचालित रूप से दोहराएं नहीं जब परिणाम अज्ञात हो। पहले संसाधन या आदेश की स्थिति पढ़ें। केवल उन एंडपॉइंट्स पर Idempotency-Key का उपयोग करें जो समर्थन का दस्तावेज़ देते हैं, जैसे समझौता परिवर्तन।
रीफ्रेश टोकन एकल-उपयोग के लिए हैं#
रिफ्रेश रोटेशन को आपके बैकएंड में प्रति-अधिकृत लॉक की आवश्यकता होती है। उपभोग किए गए रिफ्रेश टोकन का ब्लाइंड रिट्राई ग्रांट को रद्द कर सकता है। देखें सुरक्षित टोकन रिफ्रेश.
समर्थन अनुरोध में क्या शामिल करें#
जब उपलब्ध हो तो एंडपॉइंट, HTTP स्थिति, त्रुटि कोड, समय और प्रतिक्रिया/कार्य पहचानकर्ता शामिल करें। Authorization हेडर, कुकीज़, क्लाइंट सीक्रेट्स, एक्सेस टोकन, रिफ्रेश टोकन और निजी प्रॉम्प्ट सामग्री हटा दें।
अंतिम अपडेट सितम्बर 15, 2026