此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
PUT
HTTP PUT 方法用請求有效負載創建新資源或替換目標資源的表示。
PUT 和 POST 之間的區別在於 PUT 是幂等的:調用一次或多次連續調用具有相同效果(即沒有副作用),而連續相同的 POST 請求可能會產生額外的效果,類似於多次下單。
語法
http
PUT /new.html HTTP/1.1
範例
請求
http
PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16
<p>New File</p>
回應
如果目標資源沒有當前表示並且 PUT 請求成功創建了一個,那麼原伺服器必須通過發送 201(Created)回應來通知用戶代理。
http
HTTP/1.1 201 Created
Content-Location: /new.html
如果目標資源具有當前表示且該表示根據所附表示的狀態成功修改,則原伺服器必須發送 200(OK)或 204(No Content)回應以指示請求的成功完成。
http
HTTP/1.1 204 No Content
Content-Location: /existing.html
規範
| Specification |
|---|
| HTTP Semantics # PUT |