Qual método HTTP utilizas para atualizar parcial ou completamente os dados na API REST?

Para atualizar dados na API REST, geralmente são utilizados os seguintes métodos HTTP:

• PUT — usado para uma atualização completa do recurso. O cliente envia uma representação completa do recurso, e o servidor substitui o recurso existente pelo novo estado.

• PATCH — aplicado para uma atualização parcial do recurso. O cliente envia apenas os campos que deseja modificar, e os demais permanecem inalterados.

Exemplo:

• Se precisar substituir todo o objeto de usuário, use PUT.
• Se desejar alterar apenas um campo, como o email, use PATCH.

Em Java, para lidar com esses métodos, pode usar anotações nos controladores, por exemplo, no Spring:

@PutMapping("/users/{id}")
public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) {
    // lógica de atualização completa
}

@PatchMapping("/users/{id}")
public ResponseEntity<User> partialUpdateUser(@PathVariable Long id, @RequestBody Map<String, Object> updates) {
    // lógica de atualização parcial
}

Assim, para atualização completa — PUT, para parcial — PATCH.