pyyntöparametrit

Pyyntöparametrit (pyyntöparametrit) ovat tietoja, joita asiakas lähettää palvelimelle pyynnön yhteydessä. Niiden tarkoituksena on määrittää, mitä resurssia haetaan, miten tulokset tulisi rajata tai järjestää sekä mitkä lisäasetukset vaikuttavat vastaukseen. Käytännössä pyyntöparametrit ilmenevät usein HTTP-pyynnöissä erilaisina muotoina.

Tyypillisesti pyyntöparametrit jaetaan useisiin ryhmiin. Polkuparametrit (path parameters) ovat osa resurssin polkua, esimerkiksi /users/{id}, ja ne identifioivat yksittäisen resursseja. Kyselyparametrit (query parameters) tulevat muutaman kysymysmerkin jälkeen URLiin, kuten ?page=2&limit=50, ja niitä käytetään hakuihin, suodattamiseen sekä sivutukseen. Otsikkoparametrit (header parameters) sijaitsevat HTTP-otsikoissa ja voivat välittää metatietoja, kuten toivotun sisällön tyypin tai autentikointitietoja. Kehonparametrit (body parameters) lähetetään POST-, PUT- tai PATCH-pyynnöissä ja ne voivat olla JSON-, XML- tai muun muodossa.

Hyvä käytäntö on erottaa pyyntöparametrit tarkoituksellisesti: kyselyparametreja käytetään hakuihin ja filtteröintiin, path-parametrit identifioivat resurssin, ja kehon parametrit välittävät luotaville tai päivitettäville tiedoille. Tietoturva ja validoitavuus ovat keskeisiä: syötteet tulisi validoida oikean tiedostotyypin ja arvon mukaan, eikä sensitiivisiä tietoja tulisi välittää epäedullisiin kanaviin kuten osaksi URL-parametreja.

Esimerkki REST-rajapinnasta: GET /books?author=Hemingway&year=1952 palauttaa teoksia, joiden author ja year vastaavat. POST /books with body {"title": "...","author":"..."} luo uuden kirjan. Pyyntöparametrien hallinta vaatii sekä asiakkaan että palvelimen tasolla suunnittelua, validointia ja turvallisuutta.