HTTP-Methoden-Referenz
Eine HTTP-Methode (oder das „Verb“) sagt dem Server, welche Aktion eine Anfrage ausführen will. Die zwei Eigenschaften in der Tabelle zählen beim API-Design:
- Sicher (Safe) — ändert den Serverzustand nicht (schreibgeschützt).
- Idempotent — die Anfrage zu wiederholen hat denselben Effekt wie sie einmal zu stellen.
Aktualisiert 2026-07-06
| Methode | Zweck | Sicher | Idempotent |
|---|---|---|---|
| GET | Eine Ressource abrufen; sollte keine Nebenwirkungen haben | Ja | Ja |
| HEAD | Wie GET, gibt aber nur Header zurück, keinen Body | Ja | Ja |
| POST | Eine Ressource erstellen oder Daten zur Verarbeitung senden | Nein | Nein |
| PUT | Eine Ressource vollständig durch den Anfrage-Body ersetzen | Nein | Ja |
| PATCH | Eine Teilaktualisierung auf eine Ressource anwenden | Nein | Nein |
| DELETE | Eine Ressource entfernen | Nein | Ja |
| OPTIONS | Fragen, welche Methoden/Header erlaubt sind (CORS-Preflight) | Ja | Ja |
| CONNECT | Einen Tunnel zum Server aufbauen (von Proxys genutzt) | Nein | Nein |
| TRACE | Die erhaltene Anfrage zurücksenden (Diagnose; oft deaktiviert) | Ja | Ja |
Beachte den Unterschied zwischen PUT und PATCH: PUT ersetzt die ganze Ressource (zweimal gesendet ist es also idempotent), während PATCH eine Teiländerung anwendet (was nicht idempotent sein muss). Kombiniere dies mit unseren Referenzen zu Statuscodes und Headern für das ganze Bild einer HTTP-Anfrage.
Verwandte Tools