Verbo HTTP: PUT
O curso trata do método HTTP PUT. Mostra como o PUT substitui um recurso numa URL conhecida ou o cria ali, e por que o corpo da requisição precisa trazer a representação completa. Explica a idempotência e por que ela torna seguras as novas tentativas, e compara PUT com POST. As aulas seguintes abordam os códigos de status da resposta, a falsificação de método em formulários HTML que só aceitam GET e POST e o tratamento do PUT na ação update do Rails.
O que você vai aprender
- ✓Como o PUT substitui ou cria um recurso numa URI específica
- ✓O que é idempotência e por que ela permite repetir requisições com segurança
- ✓As diferenças entre PUT e POST em direcionamento e repetição
- ✓Os códigos de status 200, 204 e 201 nas respostas ao PUT
- ✓A falsificação de método com o campo oculto _method em formulários HTML
- ✓Como o Rails mapeia requisições PUT para a ação update
O que é o método PUT?
O método HTTP PUT tem uma função. Ele substitui o recurso numa URL específica, ou o cria se ele ainda não existir.
Ler a aula completa grátis →Currículo
7 aulasO que é o método PUT?
O PUT substitui o recurso numa URL ou o cria, e exige a representação completa no corpo.
O conceito de idempotência
Operações idempotentes têm o mesmo resultado quando repetidas, o que permite repetir requisições PUT que falharam.
Anatomia de uma requisição PUT
Uma requisição PUT aponta para uma URI específica, leva um corpo completo e usa os cabeçalhos Content-Type e Content-Length.
PUT versus POST
O POST aponta para uma coleção e cria duplicatas ao repetir, já o PUT aponta para um recurso conhecido e é idempotente.
A resposta de uma requisição PUT
Um PUT bem-sucedido retorna 200 OK com dados, 204 No Content com corpo vazio ou 201 Created.
Formulários HTML e PUT
Formulários HTML não enviam PUT, então frameworks leem um campo oculto _method, e o fetch do JavaScript envia PUT real.
Requisições PUT no Rails
O Rails direciona o PUT para a ação update, e o form_with adiciona o campo oculto _method para registros existentes.