Реците нам о PUT методу у REST API-ју.

Metod PUT se koristi za kreiranje ili ažuriranje resursa na specificiranoj URI.

Ključne osobine:

• Idempotentnost: Ponavljanje iste PUT zahteva sa istim telom će dovesti do istog stanja resursa na serveru (iako odgovor servera može varirati).
• Potpuna zamena: PUT zahtev šalje potpunu reprezentaciju resursa, zamenjujući postojeći.
• Kreiranje ili ažuriranje: Ako resurs na datoj URI ne postoji, PUT ga kreira. Ako postoji, ažurira ga. Uspešan PUT zahtev obično vraća status 201 Created ako je resurs kreiran. Ažuriranje postojećeg resursa obično vraća 200 OK ili 204 No Content (ako nema tela u odgovoru).

Tipični scenariji korišćenja:

• Potpuna ažuriranja korisničkog profila.
• Kreiranje resursa ako klijent definiše njegov URI.

Primer PUT zahteva:

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

{
  "id": 123,
  "name": "Novi Ime",
  "email": "new.email@example.com"
}

Server će primiti ovaj zahtev i ili kreirati korisnika sa ID-jem 123 ili će potpuno zameniti informacije o korisniku sa tim ID-jem podacima iz tela zahteva.

PUT se razlikuje od POST na sledeći način:

• PUT se koristi za ažuriranje ili kreiranje resursa na poznatom URI, koji definiše klijent. POST se koristi za kreiranje resursa, gde server definiše URI novog resursa, ili za druge radnje koje ne spadaju pod druge HTTP metode.
• PUT je idempotentan, POST nije. Višestruki POST zahtevi sa istim telom mogu kreirati više istih resursa ili izazvati različite sporedne efekte.

Tabela poređenja PUT i POST:

Karakteristika	PUT	POST
Svrha	Kreiranje ili ažuriranje resursa	Kreiranje resursa, slanje podataka
Idempotentnost	Da	Ne
Definisanje URI	Od strane klijenta	Od strane servera
Uticaj na resurs	Potpuno zamenjuje ili kreira	Obično dodaje ili izvršava radnju