400 Bad Request
Der HTTP-Statuscode 400 Bad Request Client-Fehlerantwort zeigt an, dass der Server die Anfrage nicht verarbeiten kann, da sie als Client-Fehler angesehen wird. Der Grund für eine 400-Antwort ist typischerweise eine fehlerhafte Anfragesyntax, ein ungültiges Anforderungsnachrichten-Format oder irreführende Anforderungsleitung.
Clients, die eine 400-Antwort erhalten, sollten erwarten, dass das Wiederholen der Anfrage ohne Änderungen mit dem gleichen Fehler scheitern wird.
Status
400 Bad Request
Beispiele
Fehlhafte Anfragesyntax
Angenommen, es gibt eine REST API mit einem Endpunkt zur Verwaltung von Benutzern unter http://example.com/users und eine POST-Anfrage mit folgendem 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. Stattdessen antwortet der Server jedoch mit einem 400 und der Antwortinhalt enthält ein message-Feld mit einigen Kontextinformationen, 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
| Specification |
|---|
| HTTP Semantics # status.400 |