DELETE request method
Phương thức HTTP DELETE yêu cầu máy chủ xóa một tài nguyên được chỉ định.
Các yêu cầu sử dụng DELETE chỉ nên được dùng để xóa dữ liệu và không nên chứa phần thân.
Note:
Ngữ nghĩa của việc gửi phần thân thông điệp trong các yêu cầu DELETE là không được xác định.
Một số máy chủ có thể từ chối yêu cầu với phản hồi lỗi client 4XX.
| Yêu cầu có phần thân | Không |
|---|---|
| Phản hồi thành công có phần thân | Có thể có |
| An toàn | Không |
| Bất biến | Có |
| Có thể lưu đệm | Không |
| Cho phép trong HTML forms | Không |
Cú pháp
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>-
Xác định tài nguyên đích của yêu cầu khi kết hợp với thông tin được cung cấp trong tiêu đề
Host. Đây là đường dẫn tuyệt đối (ví dụ:/path/to/file.html) trong các yêu cầu đến máy chủ gốc, và là URL tuyệt đối trong các yêu cầu đến proxy (ví dụ:http://www.example.com/path/to/file.html). <query>Optional-
Thành phần truy vấn tùy chọn được đặt trước dấu hỏi
?. Thường được dùng để mang thông tin nhận dạng dưới dạng các cặpkey=value.
Ví dụ
Xóa tài nguyên thành công
Yêu cầu sau đây yêu cầu máy chủ xóa tài nguyên file.html:
DELETE /file.html HTTP/1.1
Host: example.com
Nếu yêu cầu thành công, có một số mã trạng thái phản hồi thành công có thể xảy ra.
Phản hồi 204 No Content có nghĩa là yêu cầu thành công và không cần gửi thêm thông tin về client:
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT
Phản hồi 200 OK có nghĩa là yêu cầu thành công và phần thân phản hồi bao gồm biểu diễn mô tả kết quả:
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 lang="vi">
<body>
<h1>File "file.html" deleted.</h1>
</body>
</html>
Phản hồi 202 Accepted có nghĩa là yêu cầu đã được chấp nhận và có khả năng sẽ thành công, nhưng tài nguyên chưa bị máy chủ xóa.
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 lang="vi">
<body>
<h1>Deletion of "file.html" accepted.</h1>
<p>See <a href="http://example.com/tasks/123/status">the status monitor</a> for details.</p>
</body>
</html>
Đặc tả
| Specification |
|---|
| HTTP Semantics # name-delete |
Khả năng tương thích với trình duyệt
Trình duyệt không sử dụng phương thức DELETE cho các hành động do người dùng khởi tạo, vì vậy "khả năng tương thích với trình duyệt" không áp dụng ở đây.
Nhà phát triển có thể thiết lập phương thức yêu cầu này bằng fetch().
Xem thêm
- Mã trạng thái HTTP:
200,202,204 - Các phương thức yêu cầu HTTP
- Mã trạng thái phản hồi HTTP
- Tiêu đề HTTP