Em que situações é preferível usar os métodos POST, PUT e PATCH ao trabalhar com REST API?

Os métodos POST, PUT e PATCH na API REST são utilizados para diferentes cenários de alteração de recursos:

• POST é usado para criar um novo recurso. Normalmente enviado para uma coleção, e o servidor cria um novo elemento com um identificador único. POST não é idempotente — requisições repetidas podem criar duplicados.

• PUT é aplicado para atualizar completamente um recurso existente ou criar um recurso em um URI conhecido. PUT é idempotente — requisições repetidas com os mesmos dados não alterarão o resultado.

• PATCH serve para atualização parcial de um recurso, quando apenas alguns campos precisam ser alterados. Também é idempotente, mas depende da implementação.

Exemplo:

• Criar um novo usuário: POST /users
• Atualizar completamente o usuário com id=1: PUT /users/1
• Atualizar parcialmente o email do usuário com id=1: PATCH /users/1

A escolha do método depende da tarefa: criação — POST, atualização completa — PUT, atualização parcial — PATCH.