حل أخطاء التحقق من الطلبات

قراءة استجابة 422

يرسل Threetone الرمز 422 Unprocessable Entity عندما يتعذر على FastAPI التحقق من مدخلات الطلب. تحتوي الاستجابة على مصفوفة detail، ويحتوي كل عنصر على:

• loc: موضع القيمة غير الصالحة، مثل body أو query أو path، يليه اسم الحقل.
• msg: شرح يمكن للبشر قراءته.
• type: قاعدة التحقق التي فشلت.

ابدأ بـ loc؛ فهو يشير إلى الجزء الذي ينبغي تغييره في الطلب.

تصحيح الطلب

تحقق مما يلي قبل إعادة الإرسال:

1. تطابق طريقة HTTP والمسار /v1/... مع العملية.
2. تتضمن طلبات JSON الترويسة Content-Type: application/json وتحتوي على JSON صالح.
3. الحقول المطلوبة موجودة وأسماؤها مطابقة للتوثيق.
4. الأرقام والقيم المنطقية والمصفوفات والكائنات تستخدم أنواع JSON المتوقعة.
5. قيم التعداد ومعلمات الاستعلام تقع ضمن القيم والنطاقات المسموح بها.

مثلًا، تقبل نقطة نهاية قائمة الوكلاء قيم page_size من 1 إلى 100. تنتج القيمة خارج هذا النطاق خطأ تحقق يحدد فيه loc موضع الخطأ بأنه query والحقل page_size.

لا تعد إرسال الطلب دون تغيير. صحح القيمة المشار إليها أولًا، ثم أرسل طلبًا جديدًا واحتفظ بـ X-Request-Id إذا استمر الفشل.