त्रुटियाँ और स्थिति कोड
Foxora API विफलताओं को HTTP स्थिति, संरचित त्रुटि कोड और x-request-id द्वारा संभालें, जबकि क्रेडेंशियल्स और त्वरित सामग्री को लॉग से बाहर रखें।
| स्थिति | मतलब | ग्राहक कार्रवाई |
|---|---|---|
400 | अमान्य अनुरोध | पेलोड ठीक करें; अपरिवर्तित पुनः प्रयास न करें. |
401 | प्रमाणीकरण विफल | खाता टोकन ताज़ा करें या बदलें. |
403 | सुविधा या योजना अस्वीकृत | पात्रता और अनुरोधित मॉडल सत्यापित करें। |
404 | मार्ग या संसाधन अनुपलब्ध | /v1 पथ और पहचानकर्ता की जाँच करें। |
429 | अनुरोध सीमा तक पहुंच गया | रीसेट मार्गदर्शन की प्रतीक्षा करें और समवर्तीता कम करें। |
5xx | सेवा विफलता | सीमित बैकऑफ़ और घबराहट के साथ सुरक्षित कार्य का पुनः प्रयास करें। |
अज्ञात मार्ग NOT_FOUND लौटाते हैं; सत्यापन विफलताएँ VALIDATION_ERROR लौटाती हैं; अप्रत्याशित विफलताएँ INTERNAL_ERROR लौटाती हैं। अपस्ट्रीम-विशिष्ट संदेश भिन्न हो सकते हैं, इसलिए गद्य से नियंत्रण प्रवाह न बनाएं।
अपेक्षित परिणाम: क्लाइंट या तो स्थायी अनुरोध त्रुटि को ठीक करता है या समर्थन के लिए अनुरोध पहचानकर्ता को बनाए रखते हुए एक सीमित पुनः प्रयास करता है।