HTTP 422 Contenido no procesable
422 Unprocessable Content significa que la petición tiene un formato correcto, pero los datos no son válidos para procesarla.
Significado
El servidor entiende el formato, por ejemplo un JSON válido, pero el contenido incumple ciertas reglas: falta un campo obligatorio, el correo es incorrecto o una fecha no está permitida. El código 422 es habitual en API REST y frameworks como Rails, Laravel y FastAPI para errores de validación.
Causas habituales
- Falta un campo obligatorio o su valor está vacío.
- Un dato tiene un formato incorrecto, como correo, teléfono o fecha.
- Un valor está fuera del rango admitido.
- Una regla de negocio de la aplicación no permite la operación.
¿Qué puede hacer un visitante?
- Revisa los valores introducidos en el formulario, especialmente los campos marcados como incorrectos, y corrígelos.
¿Qué puede hacer el administrador?
- Devuelve en la respuesta API una lista de campos y mensajes claros para cada error.
- Usa 400 para peticiones mal formadas y 422 para datos inválidos dentro de una petición bien estructurada.
- Valida en el navegador para mejorar el uso y mantén siempre la validación del lado del servidor.
Impacto en SEO
Los estados 422 aparecen principalmente en formularios y API, por lo que normalmente no afectan a la indexación de las páginas públicas.
Preguntas frecuentes
¿Cuál es la diferencia entre HTTP 400 y 422?
400 indica una petición mal formada; 422 indica una solicitud con formato correcto pero contenido no válido.
¿Por qué FastAPI responde con HTTP 422?
Porque los datos enviados no coinciden con el modelo esperado, por ejemplo por tipos incorrectos o campos obligatorios ausentes.