HTTPmetodeilla

HTTPmetodeilla viitataan HTTP-protokollan pyyntöihin liitettyihin toimintoihin, joiden avulla asiakas kertoo palvelimelle, mitä haluaa kohteelle tehdä. Yleisimmät metodit ovat GET, POST, PUT, DELETE, PATCH sekä HEAD, OPTIONS ja TRACE. Kukin metodi määrittelee sen, millaisen vaikutuksen pyynnöllä on resursseille, joille URI osoittaa. GET hakee resurssin, POST luo uuden resurssin tai suorittaa palvelinpuolen käsittelyn, PUT luo tai korvaa resurssin, PATCH päivittää sitä osittain ja DELETE poistaa sen. HEAD vastaa GET:in otsikoita, OPTIONS kertoo, mitä toimintoja resursi tukee, ja TRACE on diagnostinen metodi, joka palauttaa pyynnön sellaisenaan.

Turvalliset metodit ovat niitä, joiden ei oletettavasti tulisi muuttaa palvelimen tilaa: pääasiassa GET, HEAD ja OPTIONS. Idempotentteja metodeja ovat tyypillisesti GET, PUT, DELETE sekä HEAD ja OPTIONS, eli useamman samanlaisen pyynnön suorittaminen ei muualta tuota muutosta. POST ja PATCH eivät yleisesti ole idempotenttejä, ja ne voivat johtaa tilan muutoksiin riippuen pyynnön sisällöstä.

HTTP-metodien käyttö on olennaista REST-tyyppisten API-rajapintojen suunnittelussa: ne määrittelevät, millaisia operaatioita resursseille voi tehdä ja miten resursseja käsitellään. Pyyntöihin vastataan tilakoodien avulla, kuten 200 OK, 201 Created, 204 No Content tai 405 Method Not Allowed.

Standardit: RFC 7231 määrittelee HTTP/1.1 -metodit ja niiden käyttäytymisen; PUT:n ja PATCH:n tarkemmat säännöt liittyvät RFC 5789 sekä REST-arkkitehtuurin periaatteisiin.