HTTP-Anfragemethoden

HTTP definiert eine Reihe von Anfragemethoden, um den Zweck der Anfrage anzuzeigen 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 eigene Semantik, aber einige Eigenschaften werden über mehrere Methoden geteilt, insbesondere können Anfragemethoden sicher, idempotent oder cacheable sein.

GET

Die GET-Methode fordert eine Darstellung der angegebenen Ressource an. Anfragen mit GET sollten nur Daten abrufen und keinen Anforderungs-Inhalt enthalten.

Die HEAD-Methode fordert eine Antwort an, die identisch mit einer GET-Anfrage ist, aber ohne einen Antwortkörper.

POST

Die POST-Methode übermittelt eine Entität an die angegebene Ressource, was oft eine Zustandsänderung oder Seiteneffekte auf dem Server verursacht.

PUT

Die PUT-Methode ersetzt alle aktuellen Darstellungen der Zielressource mit dem Anforderungs-Inhalt.

DELETE

Die DELETE-Methode löscht die angegebene Ressource.

CONNECT

Die CONNECT-Methode stellt einen Tunnel zum Server her, der durch die Zielressource identifiziert wird.

OPTIONS

Die OPTIONS-Methode beschreibt die Kommunikationsoptionen für die Zielressource.

TRACE

Die TRACE-Methode führt einen Nachrichtenrücklauf-Test entlang des Pfads zur Zielressource durch.

PATCH

Die PATCH-Methode wendet partielle Änderungen auf eine Ressource an.

Sichere, idempotente und cachefähige Anfragemethoden

Die folgende Tabelle listet HTTP-Anfragemethoden und deren Kategorisierung hinsichtlich 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 die Antworten explizit Frische-Informationen und einen passenden Content-Location-Header enthalten.

Spezifikationen

Specification
HTTP Semantics
# POST
HTTP Semantics
# PUT
HTTP Semantics
# HEAD
HTTP Semantics
# CONNECT
HTTP Semantics
# OPTIONS
HTTP Semantics
# DELETE
HTTP Semantics
# GET

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch