422 Unprocessable Content
4xx Erreur client
RFC 9110
La requête est arrivée sans problème. Les données dedans n'ont pas de sens.
Que signifie 422 Unprocessable Content {#what}
La requête était syntaxiquement correcte (JSON valide, bon content type) mais sémantiquement invalide — les données ont échoué aux règles métier ou de validation. Un des codes les plus utiles pour le design d’API.
Quand vous verrez une 422 {#when}
- Soumission d’un formulaire avec une adresse email invalide
- Envoi d’une plage de dates où la fin est avant le début
- Violation d’une règle métier (ex. réservation d’une salle déjà prise)
- Champs requis manquants qui ont passé la validation structurelle
Quand utiliser 422 {#use}
- À préférer au 400 quand la structure de la requête est valide mais que le contenu échoue à la validation
- Retournez toujours un body d’erreur détaillé listant quels champs ont échoué et pourquoi