# त्रुटियाँ और स्थिति कोड

Foxora API विफलताओं को HTTP स्थिति, संरचित त्रुटि कोड और `x-request-id` द्वारा संभालें, जबकि क्रेडेंशियल्स और त्वरित सामग्री को लॉग से बाहर रखें।

| स्थिति | मतलब | ग्राहक कार्रवाई |
| --- | --- | --- |
| `400` | अमान्य अनुरोध | पेलोड ठीक करें; अपरिवर्तित पुनः प्रयास न करें. |
| `401` | प्रमाणीकरण विफल | खाता टोकन ताज़ा करें या बदलें. |
| `403` | सुविधा या योजना अस्वीकृत | पात्रता और अनुरोधित मॉडल सत्यापित करें। |
| `404` | मार्ग या संसाधन अनुपलब्ध | `/v1` पथ और पहचानकर्ता की जाँच करें। |
| `429` | अनुरोध सीमा तक पहुंच गया | रीसेट मार्गदर्शन की प्रतीक्षा करें और समवर्तीता कम करें। |
| `5xx` | सेवा विफलता | सीमित बैकऑफ़ और घबराहट के साथ सुरक्षित कार्य का पुनः प्रयास करें। |

अज्ञात मार्ग `NOT_FOUND` लौटाते हैं; सत्यापन विफलताएँ `VALIDATION_ERROR` लौटाती हैं; अप्रत्याशित विफलताएँ `INTERNAL_ERROR` लौटाती हैं। अपस्ट्रीम-विशिष्ट संदेश भिन्न हो सकते हैं, इसलिए गद्य से नियंत्रण प्रवाह न बनाएं।

**अपेक्षित परिणाम:** क्लाइंट या तो स्थायी अनुरोध त्रुटि को ठीक करता है या समर्थन के लिए अनुरोध पहचानकर्ता को बनाए रखते हुए एक सीमित पुनः प्रयास करता है।