400 Bad Request
Der HTTP-Statuscode 400 Bad Request Client-Fehlerantwort zeigt an, dass der Server die Anfrage aufgrund eines Fehlers, den der Server als vom Client verursacht betrachtet, nicht verarbeiten kann. Der Grund für eine 400-Antwort liegt typischerweise in einer fehlerhaften Anfrage-Syntax, ungültigem Rahmen der Anfragenachricht oder irreführender Anfragen-Weiterleitung.
Clients, die eine 400-Antwort erhalten, sollten davon ausgehen, dass das Wiederholen der Anfrage ohne Änderung mit demselben Fehler fehlschlagen wird.
Status
400 Bad Request
Beispiele
Fehlerhafte Anfrage-Syntax
Angenommen, es gibt eine REST-API mit einem Endpoint zur Verwaltung von Nutzern unter http://example.com/users und eine POST-Anfrage mit folgendem Body versucht, einen Nutzer zu erstellen, aber verwendet ungültiges JSON mit nicht-escaped Zeilenumbrüchen:
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 38
{
"email": "b@example.com",
"username": "b.smith"
}
Wenn der Inhalt in einem gültigen Format vorliegt, würden wir eine 201 Created-Antwort oder eine andere Erfolgsmeldung erwarten. Stattdessen antwortet der Server mit einem 400 und der Antwort-Body enthält ein message-Feld mit Kontext, sodass der Client die Aktion mit einer korrekt formatierten Anfrage erneut versuchen kann:
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 71
{
"error": "Bad request",
"message": "Request body could not be read properly.",
}
Spezifikationen
| Spezifikation |
|---|
| HTTP Semantics # status.400 |