DELETE
HTTP meetod
HTTP-meetodi DELETE spetsifikatsioon
Metoodika DELETE taotleb, et päritoluserver eemaldaks seose sihtressursi ja selle praeguse funktsionaalsuse vahel. Tegelikult on see meetod sarnane UNIXi käsuga rm: see väljendab pigem kustutamistoimingut päritoluserveri URI kaardistamisel kui ootust, et varem seotud teave kustutatakse.
Kui sihtressursil on üks või mitu praegust kujutist, võib päritoluserver need hävitada või mitte ning seotud salvestusruumi võib taastada või mitte, sõltudes täielikult ressursi olemusest ja selle rakendamisest päritoluserveri poolt (mis ei kuulu käesoleva spetsifikatsiooni kohaldamisalasse). Samuti võib olla vaja deaktiveerida või arhiveerida DELETE'i tulemusena muud ressursi rakendamise aspektid, näiteks andmebaasi- või väravaühendused. Üldiselt eeldatakse, et lähteserver lubab DELETE'i ainult sellistele ressurssidele, mille jaoks tal on ettenähtud mehhanism kustutamise teostamiseks.
Võõrreldes vähesed ressursid lubavad DELETE-meetodit -- seda kasutatakse peamiselt kaugautorluskeskkondades, kus kasutajal on mingi suunamine selle mõju osas. Näiteks ressurss, mis on eelnevalt loodud PUT päringuga või tuvastatud Location päise väljal pärast 201 (Created) vastust POST päringule, võib lubada vastavat DELETE päringut nende toimingute tühistamiseks. Samamoodi võivad kohandatud kasutajaagentide rakendused, mis rakendavad autorifunktsiooni, näiteks HTTP-d kaugoperatsioonideks kasutavad versioonikontrolli kliendid, kasutada DELETE'i, mis põhineb eeldusel, et serveri URI-ruum on kujundatud nii, et see vastab versioonirepositooriumile.
Kui DELETE-meetodit edukalt rakendatakse, PEAB päritoluserver saatma staatuskoodi 202 (Accepted), kui toiming tõenäoliselt õnnestub, kuid seda ei ole veel teostatud, staatuskoodi 204 (No Content), kui toiming on teostatud ja edasist teavet ei ole vaja esitada, või staatuskoodi 200 (OK), kui toiming on teostatud ja vastusesõnum sisaldab staatust kirjeldavat esitlust.
DELETE päringusõnumil ei ole määratletud semantikat; DELETE päringusõnumil kasutatava koormuse saatmine võib põhjustada mõne olemasoleva rakenduse taotluse tagasilükkamise.
DELETE meetodi vastused ei ole vahemällu paigutatavad. Kui DELETE päring läbib vahemälu, kus on üks või mitu salvestatud vastust tegeliku päringu URI jaoks, siis need salvestatud vastused muudetakse kehtetuks (vt [RFC7234] punkt 4.4).
Kui DELETE päring läbib vahemälu, siis need vastused muudetakse kehtetuks (vt [RFC7234] punkt 4.4).Meetodi DELETE kirjeldus
Näide HTTP-meetodi DELETE kohta
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