restcookbook.com

Quando dovremmo usare PUT e quando dovremmo usare POST?

I metodi HTTP POST e PUT non sono l’equivalente HTTP della creazione e dell’aggiornamento di CRUD. Entrambi hanno uno scopo diverso. È abbastanza possibile, valido e persino preferito in alcune occasioni, utilizzare PUT per creare risorse o utilizzare POST per aggiornare le risorse.

Usa PUT quando puoi aggiornare completamente una risorsa attraverso una risorsa specifica. Ad esempio, se sai che un articolo risiede in http://example.org/article/1234, puoi INSERIRE una nuova rappresentazione di risorsa di questo articolo direttamente tramite un PUT su questo URL.

Se non si conosce la posizione effettiva della risorsa, ad esempio, quando si aggiunge un nuovo articolo, ma non si ha idea di dove memorizzarlo, è possibile pubblicarlo su un URL e lasciare che il server decida l’URL effettivo.

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

non appena si conosce l’ubicazione della risorsa, è possibile utilizzare MESSO di nuovo a fare gli aggiornamenti al blu cucitrice articolo. Ma come detto prima: è possibile aggiungere nuove risorse attraverso PUT pure. Il prossimo esempio è perfettamente valido se la tua API fornisce questa funzionalità:

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