用请求负载整体替换目标资源，若不存在则创建。PUT 幂等。
快速事实
| 属性 | 值 |
|---|---|
| 安全（不改变资源状态） | 否 |
| 幂等（重复请求结果相同） | 是 |
| 可缓存 | 否 |
描述
用请求负载整体替换目标资源，若不存在则创建。PUT 幂等。
示例
curl -X PUT https://api.example.com/users/1 -H "Content-Type: application/json" -d '{"name":"Ada"}'请求示例
PUT /api/users/1 HTTP/1.1
Host: example.com
Content-Type: application/json
{"name":"Ada"}PUT 与 PATCH 的区别
| PUT | PATCH |
|---|---|
| 整体替换资源 | 局部修改 |
| 幂等 | 不保证幂等 |
| 需要完整请求体 | 负载更小 |
全部 HTTP 方法
常见问题
PUT 不是安全方法，调用它可能会改变资源状态。
PUT 是幂等的：重复请求的结果与单次请求相同。
来源与规范
继续探索
相关状态码
相关头