Qual é a diferença entre PUT e PATCH na API REST?

Na API REST, os métodos PUT e PATCH são usados para atualizar recursos, mas diferem em significado e comportamento:

• PUT — atualização completa do recurso. Ao chamar PUT, o cliente envia uma representação completa do recurso, e o servidor substitui o recurso existente pela enviada. Se alguns campos não forem especificados, geralmente são apagados ou removidos.

• PATCH — atualização parcial do recurso. O cliente envia apenas os campos que deseja modificar, e o servidor atualiza apenas esses, deixando os demais inalterados.

Exemplo:

PUT /users/123
{
  "name": "Ivan",
  "email": "ivan@example.com"
}

Substituirá todo o perfil do usuário.

PATCH /users/123
{
  "email": "new_email@example.com"
}

Apenas atualizará o email, os demais dados permanecerão iguais.