DELETE
Metode HTTP
Spesifikasi metode HTTP DELETE
Metode DELETE meminta server asal untuk menghapus hubungan antara sumber daya target dengan fungsionalitasnya saat ini. Pada dasarnya, metode ini mirip dengan perintah rm di UNIX: metode ini menyatakan operasi penghapusan pada pemetaan URI dari server asal, bukan harapan bahwa informasi yang sebelumnya terkait akan dihapus.
Jika sumber daya target memiliki satu atau beberapa representasi saat ini, representasi tersebut mungkin akan dimusnahkan oleh server asal, dan penyimpanan yang terkait mungkin akan diklaim kembali, tergantung sepenuhnya pada sifat sumber daya dan implementasinya oleh server asal (yang berada di luar cakupan spesifikasi ini). Demikian juga, aspek implementasi lain dari sumber daya mungkin perlu dinonaktifkan atau diarsipkan sebagai hasil dari DELETE, seperti database atau koneksi gateway. Secara umum, diasumsikan bahwa server asal hanya akan mengizinkan DELETE pada sumber daya yang memiliki mekanisme yang ditentukan untuk menyelesaikan penghapusan.
Relatif sedikit sumber daya yang mengizinkan metode DELETE - penggunaan utamanya adalah untuk lingkungan penulisan jarak jauh, di mana pengguna memiliki beberapa arahan terkait efeknya. Sebagai contoh, sumber daya yang sebelumnya dibuat menggunakan permintaan PUT, atau diidentifikasi melalui bidang header Lokasi setelah respons 201 (Dibuat) terhadap permintaan POST, dapat mengizinkan permintaan DELETE yang sesuai untuk membatalkan tindakan tersebut. Demikian pula, implementasi agen pengguna khusus yang mengimplementasikan fungsi penulisan, seperti klien kontrol revisi yang menggunakan HTTP untuk operasi jarak jauh, dapat menggunakan DELETE berdasarkan asumsi bahwa ruang URI server telah dibuat agar sesuai dengan repositori versi.
Jika metode DELETE berhasil diterapkan, server asal HARUS mengirimkan kode status 202 (Diterima) jika tindakan tersebut kemungkinan besar akan berhasil tetapi belum diberlakukan, kode status 204 (Tidak Ada Konten) jika tindakan tersebut telah diberlakukan dan tidak ada informasi lebih lanjut yang harus diberikan, atau kode status 200 (OK) jika tindakan tersebut telah diberlakukan dan pesan respons menyertakan representasi yang menggambarkan status.
Muatan dalam pesan permintaan DELETE tidak memiliki semantik yang ditetapkan; mengirim badan muatan pada permintaan DELETE dapat menyebabkan beberapa implementasi yang ada menolak permintaan tersebut.
Respon terhadap metode DELETE tidak dapat di-cache. Jika permintaan DELETE melewati cache yang memiliki satu atau lebih respons tersimpan untuk URI permintaan yang efektif, respons tersimpan tersebut akan dibatalkan (lihat Bagian 4.4 [RFC7234]).
Deskripsi metode DELETE
Contoh untuk metode HTTP DELETE
DELETE /data/item/123 HTTP/1.1
Host: api.example.com
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)Chrome/58.0.3029.110 Safari/537
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept-Language: de-DE,de;q=0.5
Connection: keep-alive
Content-Type: application/json
Date: Mon, 31 July 2023 14:58:12 GMT
Server: Apache/2.4.7 (Ubuntu)
Cache-Control: no-store