ข้ามไปยังเนื้อหา

แก้ไขข้อผิดพลาดการตรวจสอบคำขอ

ใช้การตอบกลับ 422 เพื่อค้นหาฟิลด์ที่ไม่ถูกต้อง แล้วแก้รูปแบบหรือค่าของคำขอ

อัปเดตเมื่อ

อ่านการตอบกลับ 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. ค่า enum และพารามิเตอร์คำค้นอยู่ในค่าและช่วงที่อนุญาต

ตัวอย่างเช่น ปลายทางรายการเอเจนต์ยอมรับค่า page_size ตั้งแต่ 1 ถึง 100 ค่าที่อยู่นอกช่วงนี้ทำให้เกิดข้อผิดพลาดการตรวจสอบ โดย loc ระบุ query และ page_size

อย่าลองส่งคำขอเดิมซ้ำโดยไม่แก้ไข แก้ค่าที่ระบุเสียก่อน แล้วส่งคำขอใหม่ หากยังล้มเหลวให้เก็บ X-Request-Id ไว้