Signification
La requête est bien formée mais contient des erreurs sémantiques, donc le serveur ne peut pas la traiter. Autrefois Unprocessable Entity.
Causes courantes
- Échec de validation (e-mail invalide, champ obligatoire manquant)
- Règle métier non respectée
- Erreurs de validation Rails ou Laravel
Comment corriger
Côté client ou visiteur
Lisez les erreurs par champ dans le corps, corrigez les valeurs et renvoyez.
Côté propriétaire du site ou de l’API
Renvoyez des erreurs par champ lisibles par machine pour que les formulaires puissent les mettre en évidence.
Exemple de réponse
HTTP/1.1
HTTP/1.1 422 Unprocessable Content
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Unprocessable Content",
"status": 422,
"errors": [
{
"field": "email",
"message": "must be a valid email address"
}
]
}Spécification
FAQ
› Les erreurs de validation doivent-elles utiliser 400 ou 422 ?
Beaucoup d'API utilisent 422 pour la validation et 400 pour une entrée illisible. Les deux sont valides ; restez cohérent.
› 422 est-il réservé à WebDAV ?
Il est né avec WebDAV, mais la RFC 9110 le définit désormais pour HTTP en général.