Ir al contenido

Resolver errores de validación de solicitudes

Usa la respuesta 422 para localizar el campo no válido y corregir la estructura o el valor de la solicitud.

Actualizado el

Lee una respuesta 422

Threetone devuelve 422 Unprocessable Entity cuando FastAPI no puede validar la entrada de una solicitud. La respuesta contiene una matriz detail. Cada elemento incluye:

  • loc: dónde se encontró el valor no válido, por ejemplo body, query o path, seguido del nombre del campo.
  • msg: una explicación legible.
  • type: la regla de validación incumplida.

Empieza por loc, que indica qué parte de la solicitud debes cambiar.

Corrige la solicitud

Verifica lo siguiente antes de volver a enviarla:

  1. El método HTTP y la ruta /v1/... corresponden a la operación.
  2. Las solicitudes JSON incluyen Content-Type: application/json y un JSON válido.
  3. Están presentes los campos obligatorios y sus nombres coinciden con los de la documentación.
  4. Los números, valores booleanos, arreglos y objetos tienen los tipos JSON esperados.
  5. Los valores enumerados y parámetros de consulta cumplen los valores e intervalos permitidos.

Por ejemplo, el endpoint de lista de agentes acepta valores de page_size entre 1 y 100. Fuera de ese intervalo, el error de validación señala query y page_size en loc.

No reintentes una solicitud sin modificarla. Corrige primero el valor indicado y, si la nueva solicitud también falla, guarda su X-Request-Id.

Artículos relacionados