الأخطاء ورموز الحالة
تعامل مع حالات فشل Foxora API حسب حالة HTTP ورمز الخطأ المنظم وx-request-id، مع الاحتفاظ ببيانات الاعتماد ومحتوى المطالبة خارج السجلات.
| الحالة | معنى | عمل العميل |
|---|---|---|
400 | طلب غير صالح | إصلاح الحمولة؛ لا تقم بإعادة المحاولة دون تغيير. |
401 | فشلت المصادقة | قم بتحديث أو استبدال الرمز المميز للحساب. |
403 | تم رفض الميزة أو الخطة | التحقق من الاستحقاق والنموذج المطلوب. |
404 | الطريق أو المورد مفقود | تحقق من مسار ومعرف /v1. |
429 | تم الوصول لسقف الطلب | انتظر إعادة تعيين التوجيه وتقليل التزامن. |
5xx | فشل الخدمة | أعد محاولة العمل الآمن مع التراجع المحدود والارتعاش. |
ترجع المسارات غير المعروفة NOT_FOUND؛ فشل التحقق من الصحة بإرجاع VALIDATION_ERROR؛ ترجع حالات الفشل غير المتوقعة INTERNAL_ERROR. قد تختلف الرسائل الخاصة بالمنبع، لذا لا تقم ببناء تدفق التحكم من النثر.
النتيجة المتوقعة: يقوم العميل إما بتصحيح خطأ الطلب الدائم أو إجراء إعادة محاولة محدودة مع الاحتفاظ بمعرف الطلب للحصول على الدعم.