DELETE

HTTP-metode

Spesifikasjon av HTTP-metoden DELETE

DELETE-metoden ber om at opprinnelsesserveren fjerner tilknytningen mellom målressursen og dens nåværende funksjonalitet. Denne metoden ligner på rm-kommandoen i UNIX: den uttrykker en sletteoperasjon på URI-kartleggingen på opprinnelsesserveren i stedet for en forventning om at den tidligere tilknyttede informasjonen skal slettes.

Hvis målressursen har en eller flere gjeldende representasjoner, kan det hende at de ødelegges eller ikke av opprinnelsesserveren, og den tilknyttede lagringen kan bli gjenvunnet eller ikke, avhengig av ressursens natur og opprinnelsesserverens implementering (noe som ligger utenfor denne spesifikasjonens omfang). På samme måte kan det hende at andre implementeringsaspekter av en ressurs må deaktiveres eller arkiveres som et resultat av en DELETE, for eksempel database- eller gateway-tilkoblinger. Generelt antas det at opprinnelsesserveren bare tillater DELETE på ressurser som den har en foreskrevet mekanisme for å utføre slettingen.

Relativt få ressurser tillater DELETE-metoden - den brukes først og fremst i eksterne forfattermiljøer, der brukeren har en viss mulighet til å bestemme effekten av den. For eksempel kan en ressurs som tidligere er opprettet ved hjelp av en PUT-forespørsel, eller som er identifisert via Location header-feltet etter et 201 (Created)-svar på en POST-forespørsel, tillate en tilsvarende DELETE-forespørsel for å oppheve disse handlingene. På samme måte kan tilpassede brukeragent-implementeringer som implementerer en forfatterfunksjon, for eksempel revisjonskontrollklienter som bruker HTTP for eksterne operasjoner, bruke DELETE basert på en antakelse om at serverens URI-område er utformet slik at det tilsvarer et versjonslager.

Hvis en DELETE-metode er vellykket, BØR opprinnelsesserveren sende en 202 (akseptert) statuskode hvis handlingen sannsynligvis vil lykkes, men ennå ikke er iverksatt, en 204 (intet innhold) statuskode hvis handlingen er iverksatt og ingen ytterligere informasjon skal leveres, eller en 200 (OK) statuskode hvis handlingen er iverksatt og svarmeldingen inneholder en representasjon som beskriver statusen.

En nyttelast i en DELETE-forespørsel har ingen definert semantikk; å sende en nyttelast i en DELETE-forespørsel kan føre til at noen eksisterende implementasjoner avviser forespørselen.

Svar på DELETE-metoden kan ikke lagres i hurtigbuffer. Hvis en DELETE-forespørsel passerer gjennom en cache som har ett eller flere lagrede svar for den aktuelle forespørsels-URI-en, vil de lagrede svarene bli ugyldiggjort (se avsnitt 4.4 i [RFC7234]).

HTTP-metode DELETE er spesifisert i avsnitt 4.3.5 i dokument RFC 7231 av Internet Engineering Task Force (IETF) og World Wide Web Consortium (W3C).

Beskrivelse av DELETE-metoden

pågående arbeid

Eksempel for HTTP-metoden 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