Tam yeniləmə üçün PATCH istifadə edilə bilirsə, niyə həm PUT, həm də PATCH metodlarına ehtiyac var?

PUT və PATCH metodları müxtəlif məqsədlər üçün xidmət edir, baxmayaraq ki, PATCH tam yeniləmə üçün də istifadə oluna bilər.

• PUT idempotent metoddur və bütün resursu tamamilə dəyişdirir. Əgər PUT sorğusu göndərirsinizsə, tam resurs təsvirini təqdim etməlisiniz və server köhnə resursu yenisi ilə əvəz edəcək.

• PATCH resursun qismən yenilənməsi üçün nəzərdə tutulub. Siz yalnız dəyişdirmək istədiyiniz sahələri göndərirsiniz, bütün obyekti göndərməyə ehtiyac yoxdur.

Hər iki metodun istifadəsi əməliyyatları aydın şəkildə ayırmağa imkan verir: PUT — tam yeniləmə, PATCH — qismən yeniləmə. Bu, API-nin oxunuşunu yaxşılaşdırır və trafik optimallaşdırır, çünki PATCH daha az məlumat göndərə bilər.

Nümunə:

PUT /users/123
{
  "name": "Иван",
  "email": "ivan@example.com"
}

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

Birinci halda istifadəçi tamamilə yenilənir, ikinci — yalnız email.