428 Precondition Required
Der HTTP-Statuscode 428 Precondition Required Client-Fehlermeldung zeigt an, dass der Server verlangt, dass die Anfrage bedingt sein muss.
Typischerweise bedeutet eine 428-Antwort, dass ein erforderlicher Vorbedingungs-Header wie If-Match fehlt.
Wenn ein Vorbedingungs-Header nicht mit dem serverseitigen Zustand übereinstimmt, sollte die Antwort 412 Precondition Failed sein.
Status
http
428 Precondition Required
Beispiele
Fehlende Vorbedingung in der Anfrage
Ein Client hat eine Ressource my-document vom Server abgerufen, sie lokal aktualisiert und versucht dann, das aktualisierte Dokument an den Server zu senden:
http
PUT /docs/my-document HTTP/1.1
Host: example.com
Content-Type: application/json
{
[…]
Die Serverimplementierung erfordert, dass alle PUT-Anfragen für den spezifischen Pfad oder Typ von Dokumenten bedingt sein müssen und sendet eine 428-Antwort:
http
HTTP/1.1 428 Precondition Required
Date: Wed, 26 Jun 2024 12:00:00 GMT
Server: Apache/2.4.1 (Unix)
Content-Type: application/json
{
"code": "MissingPrecondition",
"message": "Updating documents requires a precondition header.",
}
Spezifikationen
| Specification |
|---|
| RFC 6585 # section-3 |