REST API-də PUT metodundan bəhs edin.

PUT metodu, müəyyən edilmiş URI-də resurs yaratmaq və ya yeniləmək üçün istifadə olunur.

Əsas xüsusiyyətlər:

• İdempotentlik: Eyni PUT tələbinin təkrarlanması, serverdə resursun eyni vəziyyətə gəlməsinə səbəb olacaq (baxmayaraq ki, serverin cavabı dəyişə bilər).
• Tam əvəzləmə: PUT tələbi, resursun tam təmsilini göndərir və mövcud olanı əvəz edir.
• Yaradılsın və ya yenilensin: Əgər URI-də göstərilən resurs mövcud deyilsə, PUT onu yaradır. Əks halda, onu yeniləyir. Uğurlu PUT tələbində resursun olmaması adətən 201 Created status kodunu qaytarır. Mövcud resursun yenilənməsi adətən 200 OK və ya 204 No Content (bədən olmadan) ilə nəticələnir.

Tipik istifadə ssenariləri:

• İstifadəçi profilinin tam yenilənməsi.
• Müştəri onun URI-sini müəyyən etdikdə resurs yaradılması.

PUT tələbinin nümunəsi:

PUT /users/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "id": 123,
  "name": "Yeni Ad",
  "email": "new.email@example.com"
}

Server bu tələbi alacaq və ya id=123 olan istifadəçini yaradacaq və ya bu ID-ə malik istifadəçinin məlumatlarını tamamilə dəyişəcək.

PUT və POST arasındakı fərqlər:

• PUT, müştəri tərəfindən müəyyən edilən URI-də resursu yeniləmək və ya yaratmaq üçün istifadə olunur. POST isə, yeni resurs yaratmaq üçün istifadə olunur və server yeni resursun URI-sini müəyyən edir və ya digər HTTP metodlarına uyğun olmayan əməliyyatlar üçün.
• PUT idempotentdir, POST isə deyil. Eyni bədənlə təkrarlanan POST tələbləri çox sayda eyni resurs yarada bilər və ya müxtəlif yan təsirlər yarada bilər.

PUT və POST-un müqayisəli cədvəli:

Xüsusiyyət	PUT	POST
Məqsəd	Resurs yaratmaq və ya yeniləmək	Resurs yaratmaq, məlumat göndərmək
İdempotentlik	Bəli	Xeyr
URI təyin edilməsi	Müştəri tərəfindən müəyyən edilir	Server tərəfindən müəyyən edilir
Resurs üzərində təsiri	Tamamilə dəyişdirir və ya yaradır	Adətən əlavə edir və ya əməliyyat həyata keçirir