# الأخطاء ورموز الحالة

تعامل مع حالات فشل Foxora API حسب حالة HTTP ورمز الخطأ المنظم و`x-request-id`، مع الاحتفاظ ببيانات الاعتماد ومحتوى المطالبة خارج السجلات.

| الحالة | معنى | عمل العميل |
| --- | --- | --- |
| `400` | طلب غير صالح | إصلاح الحمولة؛ لا تقم بإعادة المحاولة دون تغيير. |
| `401` | فشلت المصادقة | قم بتحديث أو استبدال الرمز المميز للحساب. |
| `403` | تم رفض الميزة أو الخطة | التحقق من الاستحقاق والنموذج المطلوب. |
| `404` | الطريق أو المورد مفقود | تحقق من مسار ومعرف `/v1`. |
| `429` | تم الوصول لسقف الطلب | انتظر إعادة تعيين التوجيه وتقليل التزامن. |
| `5xx` | فشل الخدمة | أعد محاولة العمل الآمن مع التراجع المحدود والارتعاش. |

ترجع المسارات غير المعروفة `NOT_FOUND`؛ فشل التحقق من الصحة بإرجاع `VALIDATION_ERROR`؛ ترجع حالات الفشل غير المتوقعة `INTERNAL_ERROR`. قد تختلف الرسائل الخاصة بالمنبع، لذا لا تقم ببناء تدفق التحكم من النثر.

**النتيجة المتوقعة:** يقوم العميل إما بتصحيح خطأ الطلب الدائم أو إجراء إعادة محاولة محدودة مع الاحتفاظ بمعرف الطلب للحصول على الدعم.