त्रुटि कोड
यह पेज त्रुटि हैंडलिंग के लिए एकमात्र प्रामाणिक स्रोत है। SDK-विशिष्ट त्रुटि कोड हर SDK के अपने एरर हैंडलिंग पेज पर दस्तावेज़ीकृत हैं; यह पेज API कॉन्ट्रैक्ट स्तर की त्रुटियों को कवर करता है।
HTTP स्टेटस कोड
| Code | Meaning |
|---|---|
200 OK | रिक्वेस्ट सफल रही। |
400 Bad Request | पेलोड बिगड़ा हुआ है या ज़रूरी फ़ील्ड मौजूद नहीं हैं। बॉडी समस्याग्रस्त फ़ील्ड की पहचान करती है। |
401 Unauthorized | ऑथेंटिकेशन मौजूद नहीं है, एक ्सपायर हो चुका है, या अमान्य है। |
403 Forbidden | ऑथेंटिकेशन मान्य है लेकिन टेनेंट अनुरोधित संसाधन के लिए सक्षम नहीं है (जैसे, आपके APIKEY में मौजूद न हो ऐसी किसी क्षमता को कॉल करना)। |
404 Not Found | संसाधन मौजूद नहीं है या ऑथेंटिकेटेड टेनेंट का नहीं है। |
409 Conflict | संसाधन मौजूद है लेकिन इस ऑपरेशन के लिए सही स्थिति में नहीं है (जैसे, अभी भी प्रगति में मौजूद प्रोसेस से दस्तावेज़ प्राप्त करना)। |
410 Gone | संसाधन मौजूद था लेकिन रिटेंशन पॉलिसी के अनुसार डिलीट कर दिया गया (दस्तावेज़ फ़ेच एंडपॉइंट), या प्रोसेस मौजूद है लेकिन एरर स्टेट में समाप्त हुई — देखें प्रोसेस प्राप्त करें। |
429 Too Many Requests | आपने रेट लिमिट पर पहुँच गए। एक्सपोनेंशियल बैकऑफ़ के साथ रीट्राई करें। |
5xx | प्लेटफ़ॉर्म त्रुटि। बैकऑफ़ के साथ रीट्राई करें; अगर बनी रहे, तो रिस्पॉन्स बॉडी और टाइमस्टैंप के साथ सपोर्ट से संपर्क करें। |
रीट्राई पॉलिसी
| Status | Should retry? | How |
|---|---|---|
5xx | हाँ | एक्सपोनेंशियल बैकऑफ़ (1s, 2s, 4s, 8s, …)। 5 प्रयासों पर सीमित करें। |
429 | हाँ | मौजूद होने पर Retry-After हेडर का पालन करें; अन्यथा एक्सपोनेंशियल बैकऑफ़। |
4xx (अन्य) | नहीं | रिक्वेस्ट गलत है। रीट्राई करने से पहले इनपुट ठीक करें। |
401 | सशर्त रूप से | एक बार एक्सेस टोकन रीफ़्रेश करें। अगर नई रिक्वेस्ट भी 401 लौटाती है, तो समस्या संरचनात्मक है — रीट्राई न करें। |
IDCloud प्लेटफ़ॉर्म फ़िलहाल क्रिएशन एंडपॉइंट पर कोई idempotency-key तंत्र उपलब्ध नहीं कराता। प्रोसेस बनाएं को रीट्राई करते समय सतर्क रहें — किसी 5xx पर नेटवर्क त्रुटि वास्तव में सर्वर-साइड पर सफल हो सकती थी, और रीट्राई एक डुप्लीकेट प्रोसेस बना देगा। संदेह होने पर, रीट्राई करने से पहले अपने आंतरिक करेलेशन ID से हाल की प्रोसेस प्राप्त करें।
SDK त्रुटियाँ कहाँ हैं
Android SDK, iOS SDK, और Flutter SDK के त्रुटि कैटलॉग हर SDK के समर्पित एरर हैंडलिंग पेज पर दस्तावेज़ीकृत हैं:
ये डिवाइस-साइड त्रुटियों (कैमरा परमिशन अस्वीकृत, कैप्चर टाइमआउट, डिवाइस पर नेटवर्क अनुपलब्ध) को कवर करते हैं — यहाँ दस्तावेज़ीकृत API-साइड त्रुटियों से अलग।