Pyyntötyypit

Pyyntötyypit viittaavat yleisesti verkkopalveluihin käytettäviin pyyntöihin, joita asiakasohjelmisto lähettää palvelimelle. Yleisimmin puhuttaessa ne liittyvät HTTP-protokollaan ja REST-tyyppisiin arkkitehtuureihin, joissa jokaisella tyypillä on tarkoitettu toiminto resurssiin.

Yleisimät pyyntötyypit ovat:

- GET: hakee resurssin tai sen esityksen. Aika usein sivuston sisältöä tai tiedostoja noudetaan ilman muutoksia palvelimelle.

- POST: luo uuden resurssin tai suorittaa palvelimella käsittelyä, joka ei ole pelkästään resurssin hakeminen. Post on tyypillisesti ei-idempotentti.

- PUT: päivittää kokonaisen resurssin tai luo sen, jos sitä ei vielä ole. Se on yleensä idempotentti.

- PATCH: tekee osittaisen päivityksen resurssiin; tarkka käyttäytyminen riippuu rajapinnasta.

- DELETE: poistaa resurssin; on yleensä idempotentti.

- HEAD: kuin GET, mutta palauttaa vain otsikot eikä kehoa; käytetään tietojen tarkistamiseen ilman varsinaista sisältöä.

- OPTIONS: kertoo, mitkä pyyntötyypit ja toiminnot ovat sallitut kohteessa; käytetään sekä kehittäjille että sovelluksille.

- TRACE: diagnosikäyttöinen pyyntö, harvemmin käytössä.

Ominaisuudet: Idempotenssi ja turvallisuus ovat keskeisiä käsitteitä. GET, HEAD ja OPTIONS ovat turvallisia ja usein idempotenttejä; PUT ja DELETE ovat yleensä idempotenttejä; POST on tyypillisesti ei-idempotentti. Pyyntöjen sisältö voi sijaita sekä URL-osoitteessa (kyselyparametrit) että kehon sisällössä (esim. JSON). Turvallisuusnäkökohdat korostavat HTTPS:n käyttöä, sensitiivisten tietojen välttämistä URL-osoitteissa sekä oikeiden autentikointi- ja CSRF-suojausten huomioimista.

Esimerkit: GET /api/users/123, POST /api/users (rakenne kehon sisällössä), PUT /api/users/123, PATCH /api/users/123, DELETE /api/users/123. Pyyntötyypit ovat keskeinen osa verkkopalvelujen arkkitehtuuria ja REST-periaatteiden toteutusta.