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, die GET verwenden, sollten nur Daten abrufen und keinen Anfrage-Inhalt enthalten.

Die HEAD-Methode verlangt eine Antwort, die mit einer GET-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

Browser-Kompatibilität

Siehe auch