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).

.

HTTP DELETE metodi RFC 7231. dokumenta 4.3.5. iedaļā ir precizējusi Interneta inženierijas darba grupa (IETF) un Pasaules tīmekļa konsorcijs (W3C).

DELETE metodes apraksts

nepabeigtie darbi

HTTP metodes DELETE piemērs

Request header:
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
Response header:
Content-Type: application/json
Date: Mon, 31 July 2023 14:58:12 GMT
Server: Apache/2.4.7 (Ubuntu)
Cache-Control: no-store