DELETE request method

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

Anfragen, die DELETE verwenden, sollten nur zum Löschen von Daten genutzt werden und dürfen keinen Body enthalten.

Hinweis: Die Semantik des Sendens eines Nachrichtenkörpers in DELETE-Anfragen ist undefiniert. Manche Server können die Anfrage mit einer 4XX-Client-Fehlermeldung ablehnen.

Anfrage hat Body	Nein
Erfolgreiche Antwort hat Body	Kann
Sicher	Nein
Idempotent	Ja
Cache-fähig	Nein
Erlaubt in HTML-Formularen	Nein

Syntax

http

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

<request-target>: Identifiziert die Zielressource der Anfrage, wenn sie mit den Informationen im Host-Header kombiniert wird. Dies ist ein absoluter Pfad (z. B. /path/to/file.html) in Anfragen an einen Origin-Server und eine absolute URL in 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 erfolgreiche Antwortstatuscodes. Eine 204 No Content-Antwort bedeutet, dass die Anfrage erfolgreich war und keine zusätzlichen Informationen an den Client gesendet 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 angenommen wurde und wahrscheinlich erfolgreich sein wird, aber die Ressource vom Server noch nicht 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

Spezifikation
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() einstellen.

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden