400 Bad Request
Der HTTP-Statuscode 400 Bad Request Client-Fehlerantwort zeigt an, dass der Server die Anfrage nicht verarbeiten konnte aufgrund eines Fehlers, den der Server als Client-Fehler ansieht. Der Grund für eine 400-Antwort liegt typischerweise in fehlerhafter Anfragesyntax, ungültigem Framing der Anfragenachricht oder irreführendem Anfragerouting.
Clients, die eine 400-Antwort erhalten, sollten erwarten, dass das Wiederholen der Anfrage ohne Änderungen mit demselben Fehler scheitern wird.
Status
400 Bad Request
Beispiele
Fehlerhafte Anfragesyntax
Angenommen, es existiert eine REST API mit einem Endpunkt zur Verwaltung von Benutzern unter http://example.com/users und eine POST-Anfrage mit dem folgenden Inhalt versucht, einen Benutzer zu erstellen, verwendet jedoch ungültiges JSON mit nicht maskierten 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 im gültigen Format vorliegt, würden wir eine 201 Created-Antwort oder eine andere Erfolgsnachricht erwarten, aber stattdessen antwortet der Server mit einem 400 und der Antworttext enthält ein message-Feld mit Kontext, damit 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
| Specification |
|---|
| HTTP Semantics # status.400 |