PUTpyynnöistä
PUT-pyynnöillä tarkoitetaan HTTP-pyyntöjä, joiden tavoitteena on asettaa tai korvata määritetty resurssi tietyllä URI-osoitteella. Pyyntö sisältää resurssin uuden tilan sen rungossa (yleensä JSON-, XML- tai muun muodossa). Kun palvelin käsittelee PUT-pyynnön, se pyrkii korvaamaan olemassa olevan resurssin tälle URI:lle tai, joissakin toteutuksissa, luomaan resurssin jos sitä ei vielä ole. PUT on määritelty osaksi HTTP/1.1 -asetuksia ja on idempotentti.
PUT on idempotentti: saman pyyntöparin toistaminen useaan kertaan johtaa samaan lopputulokseen kuin kerran toteutetulla pyynnöllä. Se
Käytäntö ja vastaukset: yleisimpiä palautusarvoja ovat 200 OK (paluu uuden tilan kanssa), 201 Created (resurssi luotiin),
Yleisiä huomioita: PUT-pyynnöt soveltuvat API-tyyppiin, jossa resurssi on yksilöity URI:lla ja sen tila on tiedettävä kokonaisuudessaan
Esimerkki: PUT /articles/123 {"title":"Uusin otsikko","content":"Sisältö..."} Tämä palauttaa tilan, joka kuvaa kyseisen artikkelin uutta sisältöä.