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 节

另请参阅