Explique o que significa o método PUT na REST API e em que casos é utilizado.

O método PUT na API REST é usado para atualizar completamente um recurso ou criá-lo se ainda não existir. Ao contrário do PATCH, que aplica alterações parciais, o PUT substitui todo o recurso pelos dados enviados.

Principais características do PUT:

• Idempotência: chamadas repetidas com os mesmos dados não alterarão o resultado.
• Geralmente usado para atualizar um objeto existente por meio de um URI conhecido.
• Se o recurso não existir, o servidor pode criá-lo com o URI especificado.

Exemplo: se você tem um usuário com ID 123, uma requisição PUT para /users/123 com uma descrição completa do usuário substituirá todos os campos desse usuário por novos valores.

Usam PUT quando é necessário garantir a substituição completa do recurso, ao invés de uma atualização parcial.