DELETE 請求方法

HTTP DELETE 方法要求伺服器刪除指定的資源。

DELETE 方法對訊息主體沒有定義語意，因此主體應為空。

請求是否有主體 可能
成功回應是否有主體 可能
安全 否
冪等 是
可快取 否
HTML 表單中是否允許 否

語法

http
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>

結合 Host 標頭提供的資訊後，用來識別請求目標資源。在發送給原始伺服器的請求中，這是一個絕對路徑（例如：/path/to/file.html）；在發送給代理伺服器的請求中，則是一個絕對 URL（例如：http://www.example.com/path/to/file.html）。

<query> 選擇性

可選的查詢元件，前面加上問號 ?。通常用於以 key=value 形式攜帶識別資訊。

範例

成功刪除資源

以下請求要求伺服器刪除資源 file.html：

http
DELETE /file.html HTTP/1.1
Host: example.com

如果請求成功，伺服器可能回傳多種成功回應狀態碼。204 No Content 回應表示請求成功且不需回傳額外資訊給用戶：

http
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT

200 OK 回應表示請求成功且回應主體包含描述結果的表示，狀態碼可能為 200（OK）。

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234

<html>
  <body>
    <h1>檔案「file.html」已刪除。</h1>
  </body>
</html>

202 Accepted 回應表示伺服器已接受請求且可能會成功，但資源尚未被刪除。

http
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234

<html>
  <body>
    <h1>已接受刪除「file.html」的請求。</h1>
    <p>詳情請參見<a href="http://example.com/tasks/123/status">狀態監控</a>。</p>
  </body>
</html>

規範

Specification
HTTP Semantics
# name-delete

瀏覽器相容性

瀏覽器不會在用戶觸發的操作中使用 DELETE 方法，因此「瀏覽器相容性」不適用。開發者可以透過 fetch() 設定此請求方法。

參見