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:
GET http://api.loc/users/
Haetaan yksi käyttäjä hänen id:nsä perusteella:
GET http://api.loc/user/1/
Luodaan käyttäjä:
POST http://api.loc/user/
Muokataan käyttäjää hänen id:nsä perusteella:
PUT http://api.loc/user/1/
Poistetaan käyttäjä hänen id:nsä perusteella:
DELETE http://api.loc/user/1/
Oletetaan, että sinulla on verkkokaupan tuotteiden API. Kuvaille verkkokaupan URL-osoitteet siten, että API:sta tulee RESTful.
