428 Precondition Required

Der HTTP-Statuscode 428 Precondition Required (Client-Fehlerantwort) zeigt an, dass der Server verlangt, dass die Anfrage bedingt ist.

Typischerweise bedeutet eine 428-Antwort, dass ein erforderlicher Bedingungs-Header wie z.B. If-Match fehlt. Wenn ein Bedingungs-Header nicht mit dem Zustand auf der Serverseite übereinstimmt, sollte die Antwort 412 Precondition Failed sein.

Status

http
428 Precondition Required

Beispiele

Fehlende Bedingung in Anfrage

Ein Client hat eine Ressource my-document vom Server abgerufen, diese 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 Dokumenttyp 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

Siehe auch