REST API-də resursları yeniləmək üçün PATCH metodunun əsas məqsədi nədir?

REST API-də PATCH metodu, resursun qismən yenilənməsi üçün istifadə olunur. Ümumiyyətlə, PUT bütün resursu dəyişdirir, lakin PATCH yalnız dəyişdirilməsi lazım olan sahələri göndərməyə imkan verir və digər sahələri dəyişdirmədən saxlayır. Bu, trafikdən qənaət edir və yalnız məlumatların bir hissəsini dəyişdirmək lazım olduqda yeniləməni sadələşdirir.

C# ilə ASP.NET Core-də PATCH istifadəsinə nümunə:

[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();
}

Burada, JsonPatchDocument User obyektinin müəyyən sahələrini dəyişdirmək üçün göstərişlər ehtiva edir.