GETpyyntöä

GETpyyntö on HTTP-protokollan käyttämä pyyntö, jolla pyritään hakemaan resurssi palvelimelta ilman, että sen tilaa muutetaan. Se on yleisesti käytössä sekä verkkosivuilla että API-rajapinnoissa, kun halutaan lukea tai näyttää tietoja. GET-pyyntöjen tavoitteena on tuottaa vastauksena resurssi tai sen kuvaus.

Rakenteeltaan pyyntö koostuu pääasiassa ensimmäisestä rivistä sekä otsakkeista. Esimerkki tavallisesta GET-pyynnöstä: GET /hakusana?q=kissa HTTP/1.1 ja mukana arvoon liittyvä Host-otsake, esimerkiksi Host: esimerkki.fi. Yleensä pyyntö ei sisällä runkoa (eli kehon dataa), ja kaikki tarvitut tiedot välitetään URL-osoitteen osana (kyselyparametrit) sekä otsakkeilla.

Käytännön seuraamukset ja ominaisuudet: GET-pyynnöt ovat idempotenttejä ja turvallisia, mikä tarkoittaa, että useat saman pyyntöviestin toistot eivät aiheuta muutoksia palvelimen tilaan ja ne voivat olla väliaikaisesti tallennettavissa välimuistiin. Pyyntöä voidaan hyödyntää välimuistin hallinnassa esimerkiksi Cache-Control-, ETag- ja Last-Modified -otsakkeilla. On huomattava, että URL-osoitteessa tai kyselyparametreissä ei tulisi välittää arkaluontoisia tietoja, sillä ne voivat kulkea palvelin- ja verkkolokeihin; käytä HTTPS-yhteyttä tarvittaessa.

Rajat ja yhteensopivuus: GET-pyynnöt ovat nopeita ja kevyitä, mutta niiden pituudelle on käytännön rajoituksia URL-rivin pituudessa, joka vaihtelee selaimen ja palvelimen mukaan. Jos vaaditaan tiedon uutta tilaa muuttavaa toiminnallisuutta, käytetään yleensä POST- tai muita HTTP-menetelmiä.