Lewati ke konten

Atasi error validasi permintaan

Gunakan respons 422 untuk menemukan kolom yang tidak valid dan memperbaiki bentuk atau nilainya.

Diperbarui

Baca respons 422

Threetone mengembalikan 422 Unprocessable Entity saat FastAPI tidak dapat memvalidasi input permintaan. Respons memiliki larik detail. Setiap item berisi:

  • loc: lokasi nilai yang tidak valid, misalnya body, query, atau path, lalu nama kolom.
  • msg: penjelasan yang dapat dibaca manusia.
  • type: aturan validasi yang gagal.

Mulailah dengan loc. Nilai itu menunjukkan bagian permintaan yang harus diubah.

Perbaiki permintaan

Periksa hal berikut sebelum mengirim ulang:

  1. Metode HTTP dan jalur /v1/... sesuai dengan operasi.
  2. Permintaan JSON menyertakan Content-Type: application/json dan berisi JSON yang valid.
  3. Kolom wajib tersedia dan nama kolom menggunakan ejaan yang didokumentasikan.
  4. Angka, nilai boolean, larik, dan objek menggunakan jenis JSON yang diharapkan.
  5. Nilai enum dan parameter kueri memenuhi nilai dan rentang yang diizinkan.

Contohnya, endpoint daftar agen menerima nilai page_size dari 1 sampai 100. Nilai di luar rentang itu menghasilkan error validasi dengan loc yang menunjukkan query dan page_size.

Jangan mencoba lagi permintaan yang tidak berubah. Perbaiki nilai yang ditunjukkan terlebih dahulu, lalu kirim permintaan baru dan simpan X-Request-Id jika masih gagal.

Artikel terkait