त्रुटियाँ
त्रुटियाँ एक ही एनवेलप साझा करती हैं (अवलोकन देखें)। code के आधार पर ब्रांच करें, meta.request_id लॉग करें, और message को इंसानों के लिए अंग्रेज़ी टेक्स्ट मानें।
क्लाइंट त्रुटियाँ
Section titled “क्लाइंट त्रुटियाँ”| कोड | स्टेटस | अर्थ और क्या करें |
|---|---|---|
validation_failed |
400 | कोई फ़ील्ड सत्यापन में विफल हुआ। field उसका नाम बताता है; details कारण बताता है। फ़ील्ड ठीक करें। |
bad_request |
400 | अनुरोध पढ़ा ही नहीं जा सका: खराब JSON, टूटी Content-Encoding स्ट्रीम, अधूरा बॉडी। ठीक करने के लिए कोई फ़ील्ड नहीं है; ट्रांसपोर्ट जाँचें। |
validation_error |
400 | X-Account-Id ऐसे एंडपॉइंट पर भेजा गया जो इसकी अनुमति नहीं देता (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout)। |
cursor_expired |
400 | पेजिनेशन कर्सर 24 घंटे से पुराना है। सूची फिर से शुरू करें। |
unauthenticated |
401 | टोकन नहीं है या अमान्य है। सेशन रिफ़्रेश करें या कुंजी जाँचें। |
invalid_signature |
401 | वेबहुक हस्ताक्षर सत्यापित नहीं हुआ। वेबहुक देखें। |
forbidden |
403 | टोकन मान्य है लेकिन अनुमति नहीं है। |
account_context_mismatch |
403 | X-Account-Id टोकन के खाते से मेल नहीं खाता। क्लाइंट की मौजूदा कंपनी की समझ भटक गई है; इसे सेशन से फिर पढ़ें। |
not_found |
404 | संसाधन मौजूद नहीं है या किसी दूसरे खाते या साइट का है। API कभी इन दोनों में अंतर नहीं बताता। |
conflict |
409 | स्थिति का टकराव: ऑप्टिमिस्टिक लॉक, यूनिक बाधा, या मौजूदा स्थिति में अनुमत न होने वाली कार्रवाई (उदाहरण के लिए मर्ज की गई बातचीत में लिखना)। |
idempotency_key_conflict |
409 | Idempotency-Key अलग बॉडी के साथ दोबारा इस्तेमाल हुई। |
payload_too_large |
413 | बॉडी इस एंडपॉइंट फ़ैमिली की सीमा से बड़ी है। |
unsupported_media_type |
415 | गलत Content-Type। |
unprocessable |
422 | मान्य JSON, लेकिन किसी व्यावसायिक नियम ने इसे अस्वीकार किया (उदाहरण के लिए कार्य समय के बाहर बुकिंग स्लॉट)। |
storage_quota_exceeded |
422 | खाता अपने प्लान की स्टोरेज सीमा तक पहुँच गया। details में used_bytes, quota_bytes और requested_bytes होते हैं; जगह खाली करें या अपग्रेड करें। |
rate_limited |
429 | धीमे चलें। Retry-After और details.retry_after_seconds का पालन करें। |
सर्वर त्रुटियाँ
Section titled “सर्वर त्रुटियाँ”| कोड | स्टेटस | अर्थ और क्या करें |
|---|---|---|
internal_error |
500 | अप्रत्याशित विफलता। एक बार दोबारा कोशिश करें, फिर request_id के साथ सपोर्ट से संपर्क करें। |
upstream_unavailable |
502 | गेटवे सेवा तक पहुँच ही नहीं सका। थोड़ी देर बाद दोबारा कोशिश आमतौर पर सफल होती है। |
service_unavailable |
503 | नियोजित रखरखाव या खुला सर्किट ब्रेकर। Retry-After हेडर के बाद दोबारा कोशिश करें। |
ai_vendor_out_of_funds |
503 | आपके AI प्रदाता ने बिलिंग कारणों से कॉल अस्वीकार की (प्रदाता से 402 या कोटा वाला 429)। प्रदाता खाते में पैसे डालें; दोबारा कोशिश से मदद नहीं मिलेगी। |
upstream_timeout |
504 | सेवा ने समय पर जवाब नहीं दिया। retry_after होने पर दोबारा कोशिश करें। |
दोबारा कोशिश करना
Section titled “दोबारा कोशिश करना”429, 502, 503, 504 और नेटवर्क विफलताओं पर एक्सपोनेंशियल बैकऑफ़ के साथ दोबारा कोशिश करें, और दोबारा कोशिश में वही Idempotency-Key भेजें ताकि कोई लेखन कभी दो बार लागू न हो। 429 के अलावा किसी 4xx पर दोबारा कोशिश न करें।