restcookbook.com

Wann sollten wir PUT und wann POST verwenden?

Die HTTP-Methoden POST und PUT sind nicht das HTTP-Äquivalent zu create und update des CRUD . Beide dienen einem anderen Zweck. Es ist durchaus möglich, gültig und in einigen Fällen sogar bevorzugt, PUT zum Erstellen von Ressourcen oder POST zum Aktualisieren von Ressourcen zu verwenden.

Verwenden Sie PUT, wenn Sie eine Ressource vollständig über eine bestimmte Ressource aktualisieren können. Wenn Sie beispielsweise wissen, dass sich ein Artikel unter http://example.org/article/1234 befindet, können Sie eine neue Ressourcendarstellung dieses Artikels direkt über diese URL einfügen.

Wenn Sie den tatsächlichen Ressourcenstandort nicht kennen, z. B. wenn Sie einen neuen Artikel hinzufügen, aber keine Ahnung haben, wo er gespeichert werden soll, können Sie ihn an eine URL senden und den Server über die tatsächliche URL entscheiden lassen.

PUT /article/1234 HTTP/1.1<article> <title>red stapler</title> <price currency="eur">12.50</price></article>

POST /articles HTTP/1.1<article> <title>blue stapler</title> <price currency="eur">7.50</price></article>HTTP/1.1 201 CreatedLocation: /articles/63636

Sobald Sie den neuen Ressourcenstandort kennen, können Sie PUT erneut verwenden, um den blauen Hefterartikel zu aktualisieren. Aber wie gesagt: Sie KÖNNEN auch neue Ressourcen über PUT hinzufügen. Das nächste Beispiel ist vollkommen gültig, wenn Ihre API diese Funktionalität bereitstellt:

PUT /articles/green-stapler HTTP/1.1<article> <title>green stapler</title> <price currency="eur">9.95</price></article>HTTP/1.1 201 CreatedLocation: /articles/green-stapler