REST API HTTP-protokollassa

Yleisesti verkkosivustoja luotaessa tietojen hakemiseen, luomiseen, muokkaamiseen ja poistamiseen käytetään vain GET- ja POST-metodeja, koska ne ovat hyvin tuettuja selaimissa ja palvelimissa. Sama koskee myös sivustojen tarjoamia API:ita. On kuitenkin olemassa erityisiä lähestymistapoja, jotka standardoivat API:ita yleisen hyödyn vuoksi sekä API:n kehittäjille että sen käyttäjille.

Yksi lähestymistavoista on REST API (usein puhutaan RESTful:sta käyttäen tätä sanaa adjektiivina). Tämän API:n perustana on HTTP-protokollan metodien laaja käyttö. Tässä lähestymistavassa GET-metodilla haetaan tietoja, POST-metodilla luodaan, PUT-metodilla muokataan ja DELETE-metodilla poistetaan.

Esimerkkinä tarkastellaan jotakin API:ta, joka manipuloi käyttäjiä. Katsotaan, milä URL-osoitteet eri toiminnoille näyttäisivät.

Haetaan kaikki käyttäjät:

urlGET http://api.loc/users/

Haetaan yksi käyttäjä hänen id:nsä perusteella:

urlGET http://api.loc/user/1/

Luodaan käyttäjä:

urlPOST http://api.loc/user/

Muokataan käyttäjää hänen id:nsä perusteella:

urlPUT http://api.loc/user/1/

Poistetaan käyttäjä hänen id:nsä perusteella:

urlDELETE http://api.loc/user/1/