restcookbook.com

quando devemos usar PUT e quando devemos usar POST?

os métodos HTTP POST e PUT não são o equivalente HTTP da criação e atualização do CRUD. Ambos servem um propósito diferente. É bastante possível, válido e até mesmo preferido em algumas ocasiões, usar PUT para criar recursos, ou Usar POST para atualizar recursos.

Use PUT quando você pode atualizar um recurso completamente através de um recurso específico. Por exemplo, se você sabe que um artigo reside em http://example.org/article/1234, você pode colocar uma nova representação de recursos deste artigo diretamente através de uma PUT neste URL.

Se você não sabe a localização real do recurso, por exemplo, quando você adiciona um novo artigo, mas não tem nenhuma idéia onde armazená-lo, você pode postá-lo em um URL, e deixar o servidor decidir o URL real.

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

assim que você souber o novo recurso de localização, você pode usar COLOCAR novamente para fazer atualizações para o azul grampeador artigo. Mas como disse antes: você pode adicionar novos recursos através de PUT também. O próximo exemplo é perfeitamente válido se a sua API fornece esta funcionalidade:

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