Quelle est la principale fonction de la méthode PATCH dans REST API pour la mise à jour des ressources?

La méthode PATCH dans l'API REST est utilisée pour mettre à jour partiellement une ressource. Contrairement à PUT, qui remplace généralement toute la ressource, PATCH permet d'envoyer uniquement les champs à modifier, laissant les autres inchangés. Cela économise du trafic et simplifie la mise à jour lorsque seule une partie des données doit être modifiée.

Exemple d'utilisation de PATCH en C# avec 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();
}

Ici, JsonPatchDocument contient des instructions pour modifier des champs spécifiques de l'objet User.