DELETE

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

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

Anfrage hat Inhalt Kann
Erfolgreiche Antwort hat Inhalt Kann
Sicher Nein
Idempotent Ja
Cacheable Nein
Erlaubt in HTML-Formularen Nein

Syntax

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

Identifiziert die Zielressource der Anfrage in Kombination mit den Informationen, die im Host-Header bereitgestellt werden. Dies ist ein absoluter Pfad (z.B., /path/to/file.html) bei Anfragen an einen Origin-Server und eine absolute URL bei Anfragen an Proxies (z.B., http://www.example.com/path/to/file.html).

<query> Optional

Eine optionale Abfragekomponente, die durch ein Fragezeichen ? eingeleitet wird. Häufig verwendet, um identifizierende Informationen in Form von key=value Paaren zu übertragen.

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 Statuscodes für erfolgreiche Antworten. 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 Antwortinhalt 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>
  <body>
    <h1>File "file.html" deleted.</h1>
  </body>
</html>

Eine 202 Accepted-Antwort bedeutet, dass die Anfrage angenommen wurde und wahrscheinlich erfolgreich sein wird, aber die Ressource 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>
  <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 die "Browser-Kompatibilität" nicht. Entwickler können diese Anfragemethode mit fetch() setzen.

Siehe auch