رفتن به محتوا

رفع خطاهای اعتبارسنجی درخواست

با پاسخ 422 کادر نامعتبر را پیدا کنید و ساختار یا مقدار درخواست را اصلاح کنید.

به‌روزرسانی‌شده در

خواندن پاسخ 422

وقتی FastAPI نتواند ورودی درخواست را اعتبارسنجی کند، Threetone پاسخ 422 Unprocessable Entity می‌دهد. پاسخ یک آرایه detail دارد. هر مورد شامل این‌هاست:

  • loc: جای مقدار نامعتبر، مانند body، query یا path، و سپس نام کادر.
  • msg: توضیحی خوانا برای انسان.
  • type: قاعده اعتبارسنجی ناموفق.

از loc شروع کنید؛ بخشی از درخواست را که باید تغییر کند نشان می‌دهد.

اصلاح درخواست

پیش از ارسال دوباره، موارد زیر را بررسی کنید:

  1. روش HTTP و مسیر /v1/... با عملیات هماهنگ‌اند.
  2. درخواست‌های JSON دارای Content-Type: application/json و JSON معتبر هستند.
  3. کادرهای ضروری حاضرند و نامشان دقیقاً مطابق مستندات است.
  4. عددها، مقدارهای بولی، آرایه‌ها و شیءها از نوع JSON موردانتظارند.
  5. مقدارهای شمارشی و پارامترهای پرس‌وجو در مقدارها و بازه‌های مجاز قرار دارند.

برای نمونه، نقطه پایانی فهرست عامل‌ها مقدار page_size از ۱ تا ۱۰۰ را می‌پذیرد. مقدار خارج از این بازه خطای اعتبارسنجی می‌دهد که loc در آن query و page_size را مشخص می‌کند.

درخواست بدون تغییر را تکرار نکنید. اول مقدار مشخص‌شده را اصلاح کنید، سپس درخواست جدید بفرستید و اگر باز هم ناموفق بود X-Request-Id آن را نگه دارید.