PUTpyynnöissä

PUT-pyynnöillä (HTTP PUT) tarkoitetaan verkkopalvelimiin lähetettäviä pyyntöjä, joiden avulla asiakas asettaa tai korvaa resurssin määritellyn URI:n kohdalla. Pyyntö sisältää resurssin esityksen (yleensä JSON tai XML) ja pyynnön kohde määritellään URI:llä. Palvelin tallentaa pyynnön mukaisen tilan resurssiin, jonka tulos riippuu siitä, onko resurssi jo olemassa vai ei.

Yksi PUT-pyyntöjen keskeisistä piirteistä on idempotenssi: saman Pyynnön toistaminen tuottaa saman resurssin tilan. Jos resurssi on olemassa, se korvataan annetulla esityksellä; jos sitä ei ole, palvelin voi luoda uuden resurssin juuri tähän URI:iin. Vastaukset riippuvat tilanteesta: 200 OK tai 204 No Content voi ilmaista, että päivitys onnistui ilman palautetta, 201 Created voi tarkoittaa uuden resurssin luomista, ja 400–499 tai 500–599 -virhekoodit kertovat virheistä.

PUT-pyynnöt eroavat POST-pyynnöistä siten, että PUT on tarkoitettu resurssin täsmälliseen asettamiseen tai korvaamiseen tietyllä URI:lla, kun taas POST voi luoda uuden resurssin ilman asiakkaan määrittämää tarkkaa URI:ta. Lisäksi PUT voidaan verrata PATCHiin: PUT yleensä korvaa koko resurssin, kun taas PATCH soveltaa osittaista muutosta; käytännössä toteutukset voivat vaihdella.

Käytännön turvallisuus ja yhteensopivuus edellyttävät oikeaa autentikointia ja käyttöoikeuksia, sekä behovianmukaisten ehtojen (esim. If-Match/ETag) hyödyntämistä sen varmistamiseksi, että päivitys kohdistuu oikeaan versioon. PUT-pyynnöt ovat yleisiä REST-rajapinnoissa ja niitä tulisi käyttää selkeästi määriteltyjen URI:iden ja oikeiden tilanvaihtojen kanssa.