HTTP-Anfragemethoden
HTTP definiert eine Reihe von Anfragemethoden, um den Zweck der Anfrage anzugeben und was erwartet wird, wenn die Anfrage erfolgreich ist. Obwohl sie auch Substantive sein können, werden diese Anfragemethoden manchmal als HTTP-Verben bezeichnet. Jede Anfragemethode hat ihre eigenen Semantiken, aber einige Eigenschaften werden über mehrere Methoden hinweg geteilt. Insbesondere können Anfragemethoden sicher, idempotent oder cacheable sein.
GET
-
Die
GET
-Methode fordert eine Darstellung der angegebenen Ressource an. Anfragen, dieGET
verwenden, sollten nur Daten abrufen und keinen Anfrage-Inhalt enthalten. HEAD
-
Die
HEAD
-Methode verlangt eine Antwort, die mit einerGET
-Anfrage identisch ist, jedoch ohne Antwortkörper. POST
-
Die
POST
-Methode übermittelt eine Entität an die angegebene Ressource, was oft eine Zustandsänderung oder Nebeneffekte auf dem Server verursacht. PUT
-
Die
PUT
-Methode ersetzt alle aktuellen Darstellungen der Zielressource durch den Anfrage-Inhalt. DELETE
-
Die
DELETE
-Methode löscht die angegebene Ressource. CONNECT
-
Die
CONNECT
-Methode etabliert einen Tunnel zum vom Zielressource identifizierten Server. OPTIONS
-
Die
OPTIONS
-Methode beschreibt die Kommunikationsoptionen für die Zielressource. TRACE
-
Die
TRACE
-Methode führt einen Nachrichtenschleifen-Test entlang des Pfads zur Zielressource durch. PATCH
-
Die
PATCH
-Methode wendet partielle Modifikationen auf eine Ressource an.
Sichere, idempotente und cacheable Anfragemethoden
Die folgende Tabelle listet HTTP-Anfragemethoden und deren Kategorisierung in Bezug auf Sicherheit, Cachefähigkeit und Idempotenz auf.
Methode | Sicher | Idempotent | Cachefähig |
---|---|---|---|
GET |
Ja | Ja | Ja |
HEAD |
Ja | Ja | Ja |
OPTIONS |
Ja | Ja | Nein |
TRACE |
Ja | Ja | Nein |
PUT |
Nein | Ja | Nein |
DELETE |
Nein | Ja | Nein |
POST |
Nein | Nein | Bedingt* |
PATCH |
Nein | Nein | Bedingt* |
CONNECT |
Nein | Nein | Nein |
* POST
und PATCH
sind cachefähig, wenn Antworten explizit Frische-Informationen und einen passenden Content-Location
-Header enthalten.
Spezifikationen
Specification |
---|
HTTP Semantics # GET |
HTTP Semantics # DELETE |
HTTP Semantics # OPTIONS |
HTTP Semantics # POST |
HTTP Semantics # HEAD |
HTTP Semantics # CONNECT |
HTTP Semantics # PUT |