DELETE
HTTP metode
HTTP metodes DELETE specifikācija
Metode DELETE pieprasa, lai izcelsmes serveris noņem saistību starp mērķa resursu un tā pašreizējo funkcionalitāti. Faktiski šī metode ir līdzīga UNIX komandai rm: tā izsaka dzēšanas operāciju attiecībā uz izcelsmes servera URI kartēšanu, nevis cerību, ka iepriekš saistītā informācija tiks dzēsta.
Ja mērķa resursam ir viena vai vairākas pašreizējās reprezentācijas, izcelsmes serveris tās var iznīcināt, bet var arī neiznīcināt, un saistītā krātuve var tikt vai netikt atgūta, un tas ir pilnībā atkarīgs no resursa veida un tā īstenošanas izcelsmes serverī (kas ir ārpus šīs specifikācijas darbības jomas). Līdzīgi DELETE gadījumā var būt nepieciešams deaktivizēt vai arhivēt citus resursa implementācijas aspektus, piemēram, datu bāzes vai vārtejas savienojumus. Kopumā tiek pieņemts, ka izcelsmes serveris atļaus DELETE tikai tādiem resursiem, kuriem tam ir noteikts mehānisms dzēšanas veikšanai.
Relatīvi maz resursu atļauj DELETE metodi - tā galvenokārt tiek izmantota attālās autorizācijas vidēs, kur lietotājam ir noteiktas norādes par tās ietekmi. Piemēram, resurss, kas iepriekš izveidots, izmantojot PUT pieprasījumu, vai identificēts, izmantojot atrašanās vietas galvenes lauku pēc 201 (Created) atbildes uz POST pieprasījumu, varētu ļaut ar attiecīgo DELETE pieprasījumu atcelt šīs darbības. Līdzīgi arī pielāgotas lietotāja aģenta implementācijas, kas īsteno autoru funkciju, piemēram, pārskatīšanas kontroles klienti, kuri izmanto HTTP attālinātām operācijām, var izmantot DELETE, pamatojoties uz pieņēmumu, ka servera URI telpa ir izveidota tā, lai atbilstu versiju repozitorijam.
Ja DELETE metode tiek sekmīgi piemērota, izcelsmes serverim PIENĀCĪGI jānosūta 202 (Pieņemts) statusa kods, ja darbība, visticamāk, būs veiksmīga, bet vēl nav izpildīta, 204 (Nav satura) statusa kods, ja darbība ir izpildīta un nav jāsniedz papildu informācija, vai 200 (OK) statusa kods, ja darbība ir izpildīta un atbildes ziņojumā ir statusa apraksts.
DELETE pieprasījuma ziņojumā esošajai lietderīgajai slodzei nav noteiktas semantikas; nosūtot DELETE pieprasījumā lietderīgās slodzes ķermeni, dažas esošās implementācijas var noraidīt pieprasījumu.
DELETE metodes atbildes nav kešējamas. Ja DELETE pieprasījums iziet cauri kešatmiņai, kurā ir viena vai vairākas saglabātās atbildes par faktisko pieprasījuma URI, šīs saglabātās atbildes tiks anulētas (sk. [RFC7234] 4.4. sadaļu).
.
DELETE metodes apraksts
HTTP metodes DELETE piemērs
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