在线文档教程

PATCH

PATCH

HTTP PATCH 请求方法应用于局部修改的资源。

HTTP PUT方法已经被定义为用完整的新体来覆盖资源,并且对于该POST方法来说,没有标准的方式来发现补丁格式支持。不像PUT,但类似POSTPATCH不幂等,这意味着连续相同的补丁请求将产生不同的影响。

要确定服务器是否支持PATCH,服务器可以通过将其添加到AllowAccess-Control-Allow-Methods(for CORS)响应头中的列表中来通告其支持。

另一个允许 PATCH 的(隐含的)指示是Accept-Patch头部的存在,它指定了服务器接受的补丁文档格式。

请求具有正文
成功的回应有身体没有
安全没有
幂等没有
可缓存没有
在 HTML 表单中允许没有

语法

PATCH /file.txt HTTP/1.1

示例

请求

PATCH /file.txt HTTP/1.1 Host: www.example.com Content-Type: application/example If-Match: "e0023aa4e" Content-Length: 100 [description of changes]

响应

204响应代码表示成功响应,因为响应不包含消息正文。

HTTP/1.1 204 No Content Content-Location: /file.txt ETag: "e0023aa4f"

规范

规范标题
RFC 5789:PATCHHTTP的PATCH方法

也可以看看

  • 204

  • Allow, Access-Control-Allow-Methods

  • Accept-Patch - 指定服务器接受的补丁文档格式。