428 Precondition Required

HTTP の 428 Precondition Required はクライアントエラーレスポンスステータスコードで、サーバーがリクエストを条件付きにする必要があることを示します。

通常、これは If-Match のような必須の前提条件ヘッダーがないことを意味します。 前提条件ヘッダーがサーバー側の状態と一致しない場合、レスポンスは 412 Precondition Failed である必要があります。

ステータス

http
428 Precondition Required

例

リクエストでの前提条件の欠落

クライアントがサーバーからリソース my-document を取得し、それをローカルで更新した後、更新した文書をサーバーに送り返そうとします。

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

{
  […]

サーバーの実装では、特定のパスまたは文書型に対するすべての PUT リクエストが条件付きで、 428 レスポンスを送信することが要求されます。

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.",
}

仕様書

Specification
RFC 6585
# section-3

関連情報