DELETE
Die DELETE
HTTP-Methode fordert den Server auf, eine spezifizierte Ressource zu löschen.
Die DELETE
-Methode hat keine definierten Semantiken für den Nachrichtentext, daher sollte dieser leer sein.
Anfrage hat einen Textkörper | Darf |
---|---|
Erfolgreiche Antwort hat einen Textkörper | Darf |
Sicher | Nein |
Idempotent | Ja |
Cachefähig | Nein |
Erlaubt in HTML-Formularen | Nein |
Syntax
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>
-
Identifiziert das Ziel der Anfrage, wenn es mit den im
Host
-Header bereitgestellten Informationen kombiniert wird. 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-
Ein optionaler Abfragekomponent, der einem Fragezeichen
?
vorangestellt ist. Häufig verwendet, um identifizierende Informationen in Form vonkey=value
-Paaren zu übertragen.
Beispiele
Erfolgreiches Löschen einer Ressource
Die folgende Anfrage fordert den Server dazu auf, die Ressource file.html
zu löschen:
DELETE /file.html HTTP/1.1
Host: example.com
Wenn die Anfrage erfolgreich ist, gibt es mehrere mögliche erfolgreiche Antwortstatus-Codes.
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/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 des Ergebnisses enthält:
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 wurde noch nicht vom Server gelöscht.
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
Siehe auch
- HTTP-Status:
200
,202
,204
- HTTP-Anfragemethoden
- HTTP-Antwortstatus-Codes
- HTTP-Header