त्रुटि एनवेलप, उत्तरों की पूरी सूची और हर एक पर क्या करना है।
एनवेलप
{ "message": "MISSING_CLIENT_ID", "details": [] }
message त्रुटि की पहचान कराता है, और details आमतौर पर खाली होता है। जब कोई फ़्लो अनुरोध अस्वीकार करता है, उदाहरण के लिए अमान्य इमेज, तो उत्तर इसी एनवेलप में रहता है और कारण message और details में होता है। अस्वीकृतियाँ देखें।
संदर्भ
| स्टेटस | message | एंडपॉइंट | रीट्राई? |
|---|---|---|---|
| 400 | INVALID_REQUEST | create | नहीं। अनुरोध ठीक करें |
| 400 | REQUEST_TOO_LARGE | create | नहीं। बॉडी 2 MiB से अधिक है |
| 400 | MISSING_<FIELD> / INVALID_<FIELD> | create | नहीं। <FIELD> अपर स्नेक केस में फ़ील्ड है, उदाहरण के लिए MISSING_CREDENTIAL_VALUE |
| 401 | खाली ("") | create, selfie | नहीं। Unico ने एक्सेस की अस्वीकार की। HUMAN_API_ACCESS_KEY जाँचें |
| 409 | CORRELATION_ID_ALREADY_USED | create | नहीं। किसी अन्य प्रोसेस के पास वह correlationId है। नया उपयोग करें |
| 422 | ATTRIBUTE_TYPE_NOT_SUPPORTED | create | नहीं। कैटलॉग कोड उपयोग करें |
| 4xx | फ़्लो का message | create | नहीं। प्रोसेस विफल के रूप में संग्रहीत है |
| 404 | PROCESS_NOT_FOUND | get, selfie | नहीं |
| 404 | SELFIE_NOT_FOUND | selfie | नहीं। प्रोसेस के लिए कोई सेल्फ़ी उपलब्ध नहीं है |
| 4xx | अस्वीकृति का message | selfie | नहीं |
| 503 | DATABASE_UNAVAILABLE | सभी | Create: नीचे देखें। Get और selfie: हाँ |
| 502 | UPSTREAM_UNAVAILABLE | सभी | Create: नीचे देखें। Get और selfie: हाँ |
| 500 | INTERNAL | सभी | Create: नीचे देखें |
create को रीट्राई करना
हर स्वीकृत create एक नया id वाला नया प्रोसेस शुरू करता है, और प्रत्येक correlationId केवल एक बार उपयोग किया जा सकता है: जो पहले से किसी भी स्थिति के प्रोसेस द्वारा उपयोग हो चुका है, वह 409 CORRELATION_ID_ALREADY_USED के साथ अस्वीकार कर दिया जाता है।
- 400, 409, 422 और अन्य अस्वीकृतियाँ: दोबारा भेजने से पहले अनुरोध ठीक करें।
- 503
DATABASE_UNAVAILABLE: कुछ भी संग्रहीत या प्रोसेस नहीं हुआ। उसीcorrelationIdके साथ रीट्राई करें। - 502 और 500: अनुरोध की पुष्टि नहीं हुई। स्वचालित रूप से रीट्राई न करें। फिर से प्रयास करने के लिए नया
correlationIdदेकर नया create भेजें।
आपके बैक-एंड के लिए अनुशंसित तरीका:
- Human Plugin को कॉल करने से पहले हर प्रयास को उसके
correlationIdके आधार पर दर्ज करें। 502या500पर, अपने व्यावसायिक नियम के अनुसार तय करें कि नया प्रयास शुरू करना है या नहीं।- संबंधित प्रयासों को अपने रिकॉर्ड में आपस में जोड़कर रखें।
पढ़ने को रीट्राई करना
GET, चाहे प्रोसेस के लिए हो या उसकी सेल्फ़ी के लिए, रीट्राई के लिए सुरक्षित है। बैकऑफ़ का उपयोग करें, और 404 पर रुक जाएँ।
रेट लिमिट
Human Plugin में कोई अंतर्निहित रेट लिमिटर नहीं है। यदि आपको सीमाएँ चाहिए, तो उन्हें अपने गेटवे पर लागू करें।