HTTPmenetelmästä

HTTP-menetelmät ovat osa HTTP-protokollaa ja määrittelevät, millaisia toimintoja asiakkaan pyyntö voi suorittaa resursseille. Ne esiintyvät pyynnön alussa ja liittyvät usein tiedon lähettämiseen, resurssin hakemiseen, luomiseen, päivittämiseen tai poistamiseen.

Yleisimmät menetelmät ja niiden pääasiallinen tarkoitus: GET hakee resurssin tai sen edustajan; se on tyypillisesti turvallinen (safe) ja idempotentti sekä usein välimuistattu. POST lähetetään uudelle resurssille tai tilan muuttamiselle, eikä se ole yleensä idempotentti. PUT luo tai päivittää resurssin annetulla URL-osoitteella ja on idempotentti. PATCH suorittaa osittaisen päivityksen, eikä sen idempotenssi ole aina taattu. DELETE poistaa resurssin ja on idempotentti. HEAD vastaa GET:tä, mutta palauttaa vain otsikot eikä vartaloa. OPTIONS kysyy palvelimen tukemat HTTP-menetelmät. TRACE on diagnostinen pyyntö, joka heijastaa pyynnön takaisin, ja CONNECT muodostaa yhteyden tunneloituna yhteytenä esimerkiksi TLS-suojauksen ohjaamiseen proxyn kautta; nämä ovat yleisesti harvinaisempia käyttötarkoituksia.

Ominaisuudet: Safe-ominaisuus tarkoittaa, että pyyntö ei muuta palvelimen tilaa, ja idempotentti pyyntö voidaan toistaa ilman vaikutusta; GET, HEAD ja OPTIONS ovat tavallisesti safeja, ja PUT sekä DELETE sekä usein PATCH voivat olla idempotenttejä. Välimuistitus kohdistuu enimmäkseen GETiin ja HEADiin; tilan muuttavat pyynnöt edellyttävät usein autentikointia ja turvatoimia, kuten CSRF-suojauksia.

Käytännön huomioita: suunnittelussa kannattaa käyttää oikeaa menetelmää, välttää sensitiivisen tiedon siirtämistä URL-osoitteisiin, sekä käyttää HTTPS-yhteyttä ja asianmukaisia suojaus- ja skaalautuvuuskäytäntöjä.

Lähteet: HTTP-menetelmät määrittelee RFC 7231 (HTTP/1.1 Semantics and Content); PATCH on RFC 5789.