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 Clientfehler betrachtet, nicht verarbeiten würde. Der Grund für eine 400-Antwort liegt typischerweise in einer fehlerhaften Anfragesyntax, ungültigen Rahmenbedingungen der Anfragenachricht oder irreführendem Anforderungsrouting.
Clients, die eine 400-Antwort erhalten, sollten erwarten, dass das Wiederholen der Anfrage ohne Änderungen mit demselben Fehler fehlschlägt.
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 aber 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 in einem gültigen Format vorliegt, würden wir eine 201 Created-Antwort oder eine andere Erfolgsmeldung erwarten, aber stattdessen antwortet der Server mit 400 und der Antwortinhalt enthält ein message-Feld mit einigen Kontextinformationen, 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 |