Alguns ensinam que POST
é para enviar dados para criação de algo e que PUT
é para atualizar, mas achei mal explicado.
Então, afinal, qual é a diferença entre o método PUT e o POST?
Quando devo usar um e outro?
Alguns ensinam que POST
é para enviar dados para criação de algo e que PUT
é para atualizar, mas achei mal explicado.
Então, afinal, qual é a diferença entre o método PUT e o POST?
Quando devo usar um e outro?
Tecnicamente nenhuma. Apenas a semântica muda. Leia a RFC:
A diferença fundamental entre requisições POST e PUT é refletida na diferença de significado da Request-URI. O URI em uma requisição POST identifica o recurso que manipulará a entidade anexa. O recursos pode ser um processo de aceitação de dados, um gateway para outro protocolo, ou uma entidade separada que aceita anotações. Em contraste, o URI na requisição PUT identifica a entidade anexa com a requisição -- o user agent sabe qual URI é intencionado e o servidor NÃO DEVE tentar aplicar a requisição para outro recurso. Se o servidor deseja que a requisição seja aplicada para um URI diferente, ele DEVE enviar uma resposta 301 (Moved Permanently); o user agent PODE então tomar sua própria decisão sobre redirecionar ou não a requisição.
Ou seja, o PUT deveria ser usado em situações mais específicas onde se quer enviar uma informação e não fazer mais nada além de armazená-la de alguma forma. O POST é mais geral, pressupõe que a informação é apenas parte do processo que será realizado. O POST permite ter efeitos colaterais quaisquer, ou pelo menos é esperado que isto possa ocorrer. Espera-se que o PUT não tenha algo desconhecido, ou indesejável. Ele é idempotente (homenagem ao bfavaretto).
Em alguns cenários é possível pensar em semânticas mais específicas (REST, estou falando de você) para cada verbo. Mas essencialmente eles funcionam de forma análoga. Em cenários de CRUD, o PUT normalmente é usado para atualizar algo e o POST para criar (ou fazer outras operações que não se encaixa no CRUD básico), assim como o GET é usado para ler, e o DELETE obviamente para apagar.
Claro que a recomendação é seguir o que diz a RFC, mas é quase seguro dizer que não importa muito. No futuro poderia ser que impusessem alguma restrição ou ter algum efeito baseado no que diz a RFC. E aí tudo o que não seguisse ela, teria problemas. "Legalmente" poderiam fazer isto, mas como ninguém segue a RFC, quebraria tanta coisa, que isto nunca vai ser mudado.
Na dúvida, todos usam o POST
que é mais conhecido e deve funcionar sempre. Tenho minhas dúvidas se não deveria ser o contrário. Mas o estrago já está feito.
Embora não responda diretamente, aconselho fortemente ler a resposta indicada pelo bfavaretto. Tem outra útil também.
O post
é um verbo HTTP
para submissão de dados dentro do pacote em qualquer tipo de requisição, muito similar ao get
, mudando apenas o local e tamanho disponível para armazenamento dos dados. Em contra partida o put
é um verbo que carrega o significado de criar elementos, como o envio de um arquivo ou entidade.
Ao solicitar um recurso, como uma consulta, é usual utilizarmos a passagem de informação usando get
.
URI: http://servidor/recurso/consulta/{id}
GET: {id}
Entretanto, utilizar o verbo get
gera URI's
individuais para cada valor informado, expondo a informação e impossibilitando uma otimização de cache caso a resposta da requisição seja a mesma. Desta maneira temos o verbo post
para carregar as informações dentro do pacote sem constar na URI
.
URI: http://servidor/recurso/consulta
POST: {id}
Os verbos put
e delete
são carregados de semântica. Ao se criar ou transferir um recurso o verbo mais adequado é o put
. Para excluir um recurso o verbo mais adequado é o delete
.
URI: http://servidor/recurso/novo
PUT: {nome,cidade,estado}
URI: http://servidor/recurso/excluir/{id}
DELETE
PUT coloca um arquivo ou recurso em um URI
específico. Se já existe um arquivo ou recurso nesse URI
, o método PUT
irá substituir o arquivo (ou recurso). Se não houver nenhum arquivo ou recurso lá, o método PUT
cria um.
POST envia dados para um URI
específico para manipular a solicitação. O servidor web
, neste ponto pode determinar o que fazer com os dados no contexto do recurso especificado.
PUT é uma operação idempotente para "colocar" (CRIAR OU SUBSTITUIR) um recurso em uma determinada URL, em outras palavras, é usado quando a URL identifica unicamente o recurso a ser criado ou atualizado, e se a operação for bem sucedida vai haver após um recurso naquela URL exatamente como você enviou, independente do que havia antes.
Para os demais casos, use POST.
Por exemplo, vamos supor uma api que permite criar ou atualizar usuários: POST /user retorna um novo usuário com os metadados enviados no corpo da requisição. Normalmente o ID é criado no servidor e retornado na resposta. PUT /user/12345 cria ou substitui o usuário 12345 com as informações enviadas no corpo da requisição
Note que no primeiro caso se repetirmos a mesma requisição teoricamente vamos estar criando outro usuário com os mesmos dados (mas com ids diferentes), ou a segunda requisição retornará algum erro, já no segundo caso vamos estar substituindo o usuário 12345 por outro exatamente igual se os dados no corpo da requisição forem os mesmos.
Obs: PUT é usado quando enviamos um objeto completo. Se você quiser atualizar só uma parte dele e não reenviar tudo, use PATCH.