Ves al contingut

Resol els errors de validació de sol·licituds

Fes servir una resposta 422 per trobar el camp no vàlid i corregir l'estructura o el valor de la sol·licitud.

Actualitzat

Llegeix una resposta 422

Threetone retorna 422 Unprocessable Entity quan FastAPI no pot validar les dades d'entrada de la sol·licitud. La resposta conté una matriu detail. Cada element inclou:

  • loc: on s'ha trobat el valor no vàlid, com ara body, query o path, seguit del nom del camp.
  • msg: una explicació comprensible.
  • type: la regla de validació que no s'ha complert.

Comença per loc. Indica la part de la sol·licitud que has de canviar.

Corregeix la sol·licitud

Abans de tornar-la a enviar, comprova el següent:

  1. El mètode HTTP i la ruta /v1/... corresponen a l'operació.
  2. Les sol·licituds JSON inclouen Content-Type: application/json i contenen JSON vàlid.
  3. Hi són tots els camps obligatoris i els noms dels camps tenen l'ortografia documentada.
  4. Els números, els booleans, les matrius i els objectes fan servir els tipus JSON esperats.
  5. Els valors d'enum i els paràmetres de consulta compleixen els valors i els intervals permesos.

Per exemple, l'endpoint de llista d'agents accepta valors de page_size entre 1 i 100. Un valor fora d'aquest interval provoca un error de validació; el seu loc indica query i page_size.

No tornis a enviar la mateixa sol·licitud sense canvis. Corregeix primer el valor indicat i envia una nova sol·licitud. Si encara falla, conserva'n el X-Request-Id.