对目标资源进行局部修改,与整体替换的 PUT 不同。
快速事实
| 属性 | 值 |
|---|---|
| 安全(不改变资源状态) | 否 |
| 幂等(重复请求结果相同) | 否 |
| 可缓存 | 否 |
描述
对目标资源进行局部修改,与整体替换的 PUT 不同。
示例
curl -X PATCH https://api.example.com/users/1 -H "Content-Type: application/json" -d '{"name":"Ada"}'请求示例
PATCH /api/users/1 HTTP/1.1
Host: example.com
Content-Type: application/json
{"name":"Ada"}PATCH 与 PUT 的区别
| PATCH | PUT |
|---|---|
| 局部修改 | 整体替换资源 |
| 不保证幂等 | 幂等 |
全部 HTTP 方法
常见问题
PATCH 不是安全方法,调用它可能会改变资源状态。
PATCH 是不幂等的:重复请求可能产生不同结果。
来源与规范
更新于 2026-08-18
继续探索
相关状态码
相关头