PUT
PUT
HTTP PUT 请求方法
创建新的资源或替换请求负载目标资源的表示。
PUT
和POST
之间的差是,PUT
是幂等:调用它一次或多次连续具有相同的效果(也就是没有侧面
的效果),在那里连续的相同POST
可具有额外的效果,如通过顺序数次。
请求具有正文 | 是 |
---|---|
成功的回应有身体 | 没有 |
安全 | 没有 |
幂等 | 是 |
可缓存 | 没有 |
在 HTML 表单中允许 | 没有 |
语法
PUT /new.html HTTP/1.1
示例
请求
PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16
<p>New File</p>
回应
如果目标资源没有当前的表示,并且PUT
请求成功创建一个,那么源服务器必须通过发送201
(Created
)响应来通知用户代理。
HTTP/1.1 201 Created
Content-Location: /new.html
如果目标资源确实具有当前的表示形式,并且根据所包含表示的状态成功修改了表示形式,则源服务器必须发送200
(OK
)或204
(No Content
)响应以指示请求的成功完成。
HTTP/1.1 204 No Content
Content-Location: /existing.html
规范
规范 | 标题 |
---|---|
RFC 7231,第4.3.4节:PUT | 超文本传输协议(HTTP / 1.1):语义和内容 |
浏览器兼容性
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
也可以看看
201
204