400 Bad Request
Le code de statut de réponse d'erreur client HTTP 400 Bad Request indique que le serveur ne traite pas la requête en raison d'une erreur que le serveur considère comme une erreur du côté client.
La raison d'une réponse 400 est généralement une syntaxe de requête mal formée, un encadrement de message de requête invalide ou un routage de requête trompeur.
Les clients qui reçoivent une réponse 400 doivent s'attendre à ce que répéter la requête sans modification échoue avec la même erreur.
Statut
400 Bad Request
Exemples
Syntaxe de requête mal formée
Supposons qu'une API REST existe avec un point de terminaison pour gérer les utilisateur·ice·s à l'adresse http://exemple.com/users et qu'une requête POST avec le corps suivant tente de créer un·e utilisateur·ice, mais utilise du JSON invalide avec des sauts de ligne non échappés :
POST /users HTTP/1.1
Host: exemple.com
Content-Type: application/json
Content-Length: 38
{
"email": "s@exemple.com
",
"username": "s.smith"
}
Si le contenu est dans un format valide, on s'attendrait à recevoir une réponse 201 Created ou un autre message de succès, mais le serveur répond à la place avec un code 400 et le corps de la réponse inclut un champ message avec du contexte pour que le client puisse réessayer l'action avec une requête correctement formée :
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 71
{
"error": "Bad request",
"message": "Request body could not be read properly.",
}
Spécifications
| Specification |
|---|
| HTTP Semantics # status.400 |