¿Cuál es el propósito principal del método PATCH en REST API para actualizar recursos?

El método PATCH en la API REST se utiliza para actualizar parcialmente un recurso. A diferencia de PUT, que generalmente reemplaza todo el recurso, PATCH permite enviar solo los campos que necesitan ser modificados, dejando los demás sin cambios. Esto ahorra tráfico y simplifica la actualización cuando solo se necesita cambiar una parte de los datos.

Ejemplo de uso de PATCH en C# con ASP.NET Core:

[HttpPatch("users/{id}")]
public IActionResult PatchUser(int id, [FromBody] JsonPatchDocument<User> patchDoc)
{
    var user = _userRepository.GetById(id);
    if (user == null) return NotFound();

    patchDoc.ApplyTo(user, ModelState);
    if (!ModelState.IsValid) return BadRequest(ModelState);

    _userRepository.Update(user);
    return NoContent();
}

Aquí, JsonPatchDocument contiene instrucciones para modificar campos específicos del objeto User.