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 हेडर्स, कुकीज, क्लायंट सीक्रेट्स, ऍक्सेस टोकन्स, रिफ्रेश टोकन्स आणि खाजगी प्रॉम्प्ट सामग्री काढा.
मासिक खर्च मर्यादा आणि बिलिंग पुनर्प्राप्ती#
प्रत्येक देणारे खाते त्याच्या स्वतःच्या मासिक AI खर्च मर्यादा प्रति ॲप्लिकेशन किंवा क्लायंट सेवेसाठी सेट करू शकते Billing → Subscriptions & Commitments मध्ये. मर्यादेमध्ये नेटवर्क खर्च आणि बिल्डर अधिभार समाविष्ट आहे, तर निश्चित सदस्यत्वे आणि पुष्टी केलेल्या खरेदी स्वतंत्र राहतात. मर्यादा त्रुटी HTTP 402 वापरते application_spending_limit_exceeded; अपुरे पात्र क्रेडिट्स HTTP 402 वापरतात insufficient_credits. दोन्ही ग्राहक बिलिंग लिंक प्रदान करतात. त्रुटी करार, स्ट्रीमिंग हाताळणी आणि एकत्रीकरण उदाहरण.
शेवटचे अद्यतन सप्टेंबर 18, 2026