REST API-деги PUT ыкмалы тууралуу айтып бериңиз.

Метод PUT колдонулат ресурсты түзүү же жаңыртуу үчүн белгилүү URI боюнча.

Негизги өзгөчөлүктөрү:

• Идемпотенттүүлүк: Бир эле PUT суроо менен бир эле денеси менен бир нече жолу иштетүү сервердеги ресурстун бирдей абалын камсыз кылат (жана жооптор ар кандай болушу мүмкүн).
• Толук алмаштыруу: PUT суроо ресурстун толук жаңы көрсөтмөсүн жөнөтөт, ал бардыгын алмаштырат.
• Түзүү же жаңыртуу: Эгер белгилүү URI боюнча ресурс жок болсо, PUT аны түзөт. Эгер бар болсо — жаңыртат. Эгер ресурс жок болсо, ийгиликтүү PUT суроо аркылуу ал түзүлөт жана көбүнесе 201 Created статусун кайтарат. Бар ресурсту жаңыртуу көбүнесе 200 OK же 204 No Content кайтарат (эч кандай дене жок болсо).

Көп колдонулган сценарийлер:

• Колдонуучунун толук профилин жаңыртуу.
• Клиент аныктайт турган URI менен ресурс түзүү.

PUT суроосунун мисалы:

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

{
  "id": 123,
  "name": "Жаңы Аты",
  "email": "new.email@example.com"
}

Сервер бул суроону алганда, ал 123 ID менен колдонуучуну түзөт же ошол ID менен колдонуучунун маалыматтарын толук алмаштырат.

PUT жана POST айырмасы:

• PUT ресурсты жаңыртуу же түзүү үчүн колдонулат белгилүү URI боюнча, ал клиент тарабынан аныкталат. POST ресурсты түзүү үчүн колдонулат, анда сервер жаңы ресурстун URI-үн аныктайт же башка аракеттер үчүн колдонулат.
• PUT идемпотенттүү, POST — эмес. Бирдей денеси бар көптөгөн POST суроолор бир нече бирдей ресурстарды түзүшү мүмкүн же ар кандай жанама таасирлерди жаратышы мүмкүн.

PUT жана POST салыштырмалуу таблицасы:

Өзгөчөлүк	PUT	POST
Максат	Ресурсты түзүү же жаңыртуу	Ресурсты түзүү, маалыматтарды жөнөтүү
Идемпотенттүүлүк	Ооба	Жок
URI аныктоо	Клиент тарабынан	Сервер тарабынан
Ресурска таасир	Толук алмаштырат же түзөт	Адатта кошот же аракет кылат