kyselyparametrit

Kyselyparametrit ovat URL-osoitteen osia, jotka seuraavat kysymysmerkkiä ja muodostuvat nimi–arvopareista. Parametrit erotellaan merkillä & ja ne välittävät lisätietoja palvelimelle, kuten hakusanan, sivunumeroa tai lajitteluperusteita. Esimerkki: https://example.fi/tuotteet?hakusana=juusto&page=2&maara=10.

Parametrit ovat yleisimmin käytössä GET-pyynnöissä, mutta niitä voidaan käyttää myös POST-pyynnön URL-osiin. Arvot ovat merkkijonoja ja ne on koodattava percent-encodingin avulla siten, että erikoismerkit ja välilyönnit tulevat asianmukaisesti esiin. Voi esiintyä sekä yksittäisiä parametreja (nimi=arvo) että toistuvia (nimi=arvo1&nimi=arvo2) sekä taulukkomaisia muotoja (valinta[]=a&valinta[]=b).

Usein kyselyparametreja hyödynnetään suodatukseen, hakuun, sivutukseen sekä muihin hakutulosten hallintaan liittyviin toimintoihin. Monet kieli- ja ympäristöt tarjoavat työkaluja niiden lukemiseen ja muokkaamiseen, esimerkiksi JavaScriptin URLSearchParams tai Pythonin urllib.parse.

Turvallisuus ja yksityisyys huomioivat, että kyselyparametrit ovat näkyvissä sekä käyttäjän selaimen historiassa että palvelimen lokissa. Siksi arkaluontoisia tai luottamuksellisia tietoja ei tule välittää kyselyparametrein, ja palvelin kannattaa validoida sekä puhdistaa saapuvat arvot. On lisäksi hyvä huomata URL-pituusrajoitukset sekä se, että sekä parametreja että niiden arvoja voi olla tarpeen käsitellä yhdenmukaisesti ja dokumentoidusti.