428 Precondition Required

Der HTTP-Statuscode 428 Precondition Required Client-Fehlerreaktion zeigt an, dass der Server verlangt, dass die Anfrage konditional ist.

Typischerweise bedeutet eine 428-Antwort, dass ein erforderlicher Vorbedingungsheader wie If-Match fehlt. Wenn ein Vorbedingungsheader nicht mit dem serverseitigen Zustand übereinstimmt, sollte die Antwort 412 Precondition Failed sein.

Status

428 Precondition Required

Beispiele

Fehlende Vorbedingung in der Anfrage

Ein Client hat eine Ressource my-document vom Server geholt, sie lokal aktualisiert und versucht dann, das aktualisierte Dokument zurück an den Server zu senden:

PUT /docs/my-document HTTP/1.1
Host: example.com
Content-Type: application/json
{
 [...]

Die Serverimplementierung verlangt, dass alle PUT-Anfragen für den spezifischen Pfad oder Dokumenttyp konditional sein müssen und sendet eine 428-Antwort:

HTTP/1.1 428 Precondition Required
Date: 2024年6月26日 12:00:00 GMT
Server: Apache/2.4.1 (Unix)
Content-Type: application/json
{
 "code": "MissingPrecondition",
 "message": "Updating documents requires a precondition header.",
}

Spezifikationen

Siehe auch

• HTTP-Statuscodes
• HTTP-konditionale Anfragen
• Konditionale Header: If-Match, If-None-Match, If-Modified-Since, If-Unmodified-Since, If-Range
• 412