DELETE request method

Die DELETE-HTTP-Methode fordert den Server auf, eine spezifizierte Ressource zu löschen.

Die DELETE-Methode hat keine definierten Semantiken für den Nachrichteninhalt, daher sollte dieser leer sein.

Anforderung hat Inhalt Darf
Erfolgreiche Antwort hat Inhalt Darf
Sicher Nein
Idempotent Ja
Zwischenspeicherbar Nein
Erlaubt in HTML-Formularen Nein

Syntax

http
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>

Identifiziert die Zielressource der Anforderung, wenn sie mit den im Host-Header bereitgestellten Informationen kombiniert wird. Dies ist ein absoluter Pfad (z. B. /path/to/file.html) bei Anfragen an einen Ursprungsserver und eine absolute URL bei Anfragen an Proxy-Server (z. B. http://www.example.com/path/to/file.html).

<query> Optional

Eine optionale Abfragekomponente, der ein Fragezeichen ? vorangestellt ist. Wird oft verwendet, um identifizierende Informationen in Form von key=value-Paaren zu übermitteln.

Beispiele

Erfolgreiches Löschen einer Ressource

Die folgende Anfrage fordert den Server auf, die Ressource file.html zu löschen:

http
DELETE /file.html HTTP/1.1
Host: example.com

Wenn die Anfrage erfolgreich ist, gibt es mehrere mögliche erfolgreiche Antwortstatuscodes. Eine 204 No Content-Antwort bedeutet, dass die Anfrage erfolgreich war und keine zusätzlichen Informationen an den Client zurückgesendet werden müssen:

http
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT

Eine 200 OK-Antwort bedeutet, dass die Anfrage erfolgreich war und der Antwortkörper eine Darstellung enthält, die das Ergebnis beschreibt:

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>File "file.html" deleted.</h1>
  </body>
</html>

Eine 202 Accepted-Antwort bedeutet, dass die Anfrage akzeptiert wurde und wahrscheinlich erfolgreich sein wird, die Ressource jedoch noch nicht vom Server gelöscht wurde.

http
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234

<html lang="en-US">
  <body>
    <h1>Deletion of "file.html" accepted.</h1>
    <p>See <a href="http://example.com/tasks/123/status">the status monitor</a> for details.</p>
  </body>
</html>

Spezifikationen

Specification
HTTP Semantics
# name-delete

Browser-Kompatibilität

Der Browser verwendet die DELETE-Methode nicht für benutzerinitiierte Aktionen, daher gilt "Browser-Kompatibilität" nicht. Entwickler können diese Anfragemethode mit fetch() setzen.

Siehe auch