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 Vorbedingungs-Header wie If-Match fehlt. Wenn ein Vorbedingungs-Header nicht dem serverseitigen Zustand entspricht, 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 zurückzusenden:

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 den Dokumenttyp bedingt sind 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