428 預期條件請求

HTTP 的428 Precondition Required 客戶端錯誤響應狀態碼指示伺服器需要請求為條件請求。

通常，428 響應意味著缺少必需的先決條件頭，例如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.",
}

規範

規範
RFC 6585
# 第 3 節

另請參閱