Como escolher entre os métodos PUT, POST e PATCH ao projetar uma API REST?

A escolha entre PUT, POST e PATCH depende da natureza da operação com o recurso:

• POST — é usado para criar um novo recurso. A solicitação geralmente é enviada para a coleção, e o servidor cria um novo elemento.

• PUT — é usado para atualização completa do recurso. O cliente envia uma representação completa do recurso, e o servidor substitui o objeto existente por essa nova versão.

• PATCH — para atualização parcial do recurso. O cliente envia apenas os campos modificados, e o servidor atualiza-os sem substituir todo o objeto.

Exemplo:

• Criar usuário — POST /users
• Atualizar todo o perfil do usuário — PUT /users/{id}
• Alterar apenas o email do usuário — PATCH /users/{id}