Aula 16: Método PUT

Desenvolvimento de API REST: Construir, Testar e Solucionar Problemas

O método PUT é utilizado em APIs REST para atualizar um recurso existente. Diferente do método POST, que cria novos dados, o PUT modifica dados que já existem no servidor.

Os clientes enviam informações atualizadas para a API, e o servidor substitui ou atualiza o recurso existente com os novos valores fornecidos na requisição.

Finalidade do Método PUT

O PUT é usado quando um cliente precisa atualizar um recurso específico. A requisição normalmente inclui o identificador do recurso juntamente com os novos dados.

Exemplos comuns incluem:

Exemplo de Requisição PUT

Uma requisição PUT é geralmente enviada para um endpoint específico que inclui o identificador do recurso que será atualizado.

PUT /api/products/5

Corpo da requisição:

{ "id": 5, "name": "Mouse Sem Fio", "price": 22, "stock": 60 }

Essa requisição instrui o servidor a atualizar o produto com ID 5 usando os novos valores fornecidos.

Processamento no Servidor

Quando o servidor recebe uma requisição PUT, ele normalmente executa as seguintes etapas:

Exemplo de Resposta

Se a atualização for bem-sucedida, o servidor pode retornar o recurso atualizado ou uma mensagem de confirmação.

{ "id": 5, "name": "Mouse Sem Fio", "price": 22, "stock": 60 }

Códigos de Status HTTP para PUT

Testando Requisições PUT

Desenvolvedores podem testar requisições PUT usando ferramentas como o Postman. Essas ferramentas permitem enviar dados JSON no corpo da requisição e verificar a resposta da API.

Exemplo de endpoint testado no Postman:

https://localhost:5001/api/products/5

Boas Práticas

Seguir essas práticas ajuda a manter uma API REST confiável e previsível.

Próximos Passos

Após implementar o método PUT, o próximo passo é implementar o método DELETE, permitindo remover recursos e completar a funcionalidade completa de CRUD na API.