428 Precondition Required

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
# section-3

另见