DELETE

Metoda HTTP

Specifikacija metode HTTP DELETE

Metoda DELETE zahteva, da izvorni strežnik odstrani povezavo med ciljnim virom in njegovo trenutno funkcionalnostjo. V bistvu je ta metoda podobna ukazu rm v sistemu UNIX: izraža operacijo brisanja na preslikavi URI izvornega strežnika in ne pričakovanja, da bodo predhodno povezane informacije izbrisane.

Če ima ciljni vir eno ali več trenutnih predstavitev, jih izvorni strežnik lahko uniči ali pa tudi ne, povezano skladišče pa se lahko povrne ali pa tudi ne, kar je povsem odvisno od narave vira in njegovega izvajanja s strani izvornega strežnika (kar presega obseg te specifikacije). Podobno bo morda treba zaradi DELETE deaktivirati ali arhivirati druge izvedbene vidike vira, kot so povezave s podatkovno bazo ali prehodom. Na splošno se domneva, da bo izvorni strežnik dovolil metodo DELETE samo za vire, za katere ima predpisan mehanizem za izvedbo izbrisa.

Relativno malo virov omogoča metodo DELETE - njena glavna uporaba je v okoljih oddaljenega avtorstva, kjer ima uporabnik nekaj navodil glede njenega učinka. Na primer, vir, ki je bil predhodno ustvarjen z zahtevo PUT ali identificiran prek naslovnega polja Location po odgovoru 201 (Created) na zahtevo POST, lahko z ustrezno zahtevo DELETE prekliče ta dejanja. Podobno lahko izvedbe uporabniškega agenta po meri, ki izvajajo funkcijo avtorizacije, kot so odjemalci za nadzor revizij, ki uporabljajo HTTP za oddaljene operacije, uporabijo DELETE na podlagi predpostavke, da je bil prostor URI strežnika oblikovan tako, da ustreza repozitoriju različic.

Če je metoda DELETE uspešno uporabljena, izvorni strežnik PRAVILNO pošlje kodo stanja 202 (Sprejeto), če bo dejanje verjetno uspešno, vendar še ni bilo izvedeno, kodo stanja 204 (Brez vsebine), če je bilo dejanje izvedeno in ni treba zagotoviti dodatnih informacij, ali kodo stanja 200 (V redu), če je bilo dejanje izvedeno in odzivno sporočilo vsebuje predstavitev, ki opisuje stanje.

Plačni tovor v sporočilu zahteve DELETE nima določene semantike; pošiljanje telesa s plačilnim tovorom v zahtevi DELETE lahko pri nekaterih obstoječih izvedbah povzroči zavrnitev zahteve.

Odgovorov na metodo DELETE ni mogoče shraniti v predpomnilnik. Če zahteva DELETE poteka skozi predpomnilnik, ki ima enega ali več shranjenih odgovorov za dejanski URI zahteve, bodo ti shranjeni odgovori razveljavljeni (glejte razdelek 4.4 [RFC7234]).

Metodo HTTP DELETE sta v oddelku 4.3.5 dokumenta RFC 7231 določila projektna skupina za internetno inženirstvo (IETF) in konzorcij za svetovni splet (W3C).

Opis metode DELETE

delo v teku

Primer za metodo HTTP DELETE

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