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 Nachrichtenkörper, daher sollte dieser leer sein.
| Anfrage hat Körper | Kann sein |
|---|---|
| Erfolgreiche Antwort hat Körper | Kann sein |
| Sicher | Nein |
| Idempotent | Ja |
| Cacheable | Nein |
| Erlaubt in HTML-Formularen | Nein |
Syntax
DELETE <request-target>["?"<query>] HTTP/1.1 <request-target>Identifiziert die Zielressource der Anfrage, wenn sie mit den im
Host-Header angegebenen Informationen kombiniert wird. Dies ist ein absoluter Pfad (z.B./path/to/file.html) in Anfragen an einen Ursprungsserver und eine absolute URL in Anfragen an Proxys (z.B.http://www.example.com/path/to/file.html).<query>OptionalEine optionale Abfragekomponente, die durch ein Fragezeichen
?eingeleitet wird. Häufig verwendet, um identifizierende Informationen in Form vonkey=value-Paaren zu übermitteln.
Beispiele
Erfolgreiches Löschen einer Ressource
Die folgende Anfrage fordert den Server 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 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/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/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 akzeptiert wurde und wahrscheinlich erfolgreich sein wird, aber die Ressource noch nicht vom Server gelöscht wurde.
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 "Browser-Kompatibilität" nicht. Entwickler können diese Anfragemethode mit fetch() festlegen.
Siehe auch
- HTTP-Status:
200,202,204 - HTTP-Anfragemethoden
- HTTP-Antwortstatuscodes
- HTTP-Header
