HTTP DELETE Method

Die HTTP-Methode DELETE fordert die Löschung der durch Request-URI identifizierten Ressource an. Sie ist idempotent, mehrfache identische DELETE-Requests haben denselben Effekt wie ein einzelner Request, und wird primär in REST-APIs für Resource Deletion verwendet.

Typ

HTTP-Methode

Syntax

DELETE-Request mit Ressourcen-URI ohne Request-Body.

http
DELETE /api/users/42 HTTP/1.1
Host: api.example.com

Direktiven

Die Direktiven definieren Lösch-Semantik und Response-Codes.

Request-URI
Identifiziert die zu löschende Ressource, typischerweise Resource-ID in URL-Pfad.
200 OK
Erfolgreiche Löschung mit Response-Body der gelöschten Ressource.
204 No Content
Erfolgreiche Löschung ohne Response-Body, häufigste REST-Konvention.
202 Accepted
Löschung akzeptiert aber noch nicht ausgeführt, für asynchrone Operationen.
404 Not Found
Ressource existiert nicht, DELETE ist idempotent daher auch bei 404 erfolgreich.
Idempotent
Mehrfache DELETE-Requests ändern Server-State nicht nach erster Löschung.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für die DELETE-Methode.

Beispiel 1 REST API Resource Deletion

http
DELETE /api/posts/123 HTTP/1.1
Host: blog.example.com
Authorization: Bearer token_abc

HTTP/1.1 204 No Content

Blog-API löscht Post mit ID 123, Response ohne Body signalisiert erfolgreiche Löschung.

Beispiel 2 Deletion mit Confirmation Response

http
DELETE /api/users/alice HTTP/1.1
Host: api.example.com
Authorization: Bearer admin_token

HTTP/1.1 200 OK
Content-Type: application/json

{
  "deleted": true,
  "resource": {
    "id": "alice",
    "email": "alice@example.com",
    "deleted_at": "2025-10-01T10:40:00Z"
  }
}

API liefert gelöschte Ressource als Confirmation für Client-seitige Audit-Logs.

Beispiel 3 Asynchrone Deletion

http
DELETE /api/datasets/large-dataset-id HTTP/1.1
Host: data.example.com
Authorization: Bearer token_xyz

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "status": "deletion_scheduled",
  "job_id": "del-job-789",
  "status_url": "/api/jobs/del-job-789"
}

Große Dataset-Löschung wird asynchron ausgeführt, Client erhält Job-ID für Status-Polling.

DELETE Idempotency Flow

DELETE Idempotente Lösch-Operation

Vorteile für die Systemarchitektur

  • RESTful Resource Management: Klare Semantik für Ressourcen-Löschung in REST-APIs
  • Idempotenz: Retry-Safe bei Netzwerk-Fehlern, mehrfache Requests harmlos
  • Asynchrone Operationen: 202 Accepted Pattern für langwierige Löschungen mit Job-Tracking

Spezifikation

RFC 9110, Section 9.3.5 – HTTP Semantics https://www.rfc-editor.org/rfc/rfc9110.html#name-delete

Weitere Spezifikationen

HTTP Status 204 - No Content, HTTP Status 200 - OK, If-Match Header