Was bedeutet die Methode?
Die Methode beschreibt die beabsichtigte Aktion. GET liest eine Ressource, HEAD nur ihre Metadaten. POST übergibt Daten zur Verarbeitung, PUT ersetzt eine Ressource und DELETE fordert ihre Entfernung an. Eine Ressource kann eine Methode mit 405 ablehnen.
Sicher und idempotent
Sichere Methoden sind zum Lesen gedacht. Eine idempotente Methode soll bei Wiederholung dieselbe beabsichtigte Wirkung auf dem Server haben. GET und HEAD erfüllen beides. PUT und DELETE sind per Definition idempotent, auch wenn Antworten abweichen können. POST ist im Allgemeinen nicht idempotent.
Warum ist das wichtig?
Ein Timeout beweist nicht, dass der Server nichts verarbeitet hat. Ein wiederholter POST kann zwei Bestellungen erzeugen. Für wiederholbare Schreibzugriffe nutzen Sie einen vom API unterstützten Idempotenzschlüssel oder prüfen zuerst den Ressourcenstatus. Der Methodenname allein garantiert keine korrekte Implementierung.