REST API HTTP protokollis
Tavaliselt veebisaitide loomisel andmete hankimiseks, loomiseks, muutmiseks ja kustutamiseks kasutatakse ainult GET ja POST meetodeid, kuna neid toetavad hästi brauserid ja serverid. Sama kehtib ka saitide poolt pakutavate API-de kohta. On siiski olemas spetsiaalsed lähenemised, mis standardiseerivad API-d üldiseks mugavuseks nii API arendajatele kui ka selle kasutajatele.
Üks lähenemistest on REST API (sageli kasutatakse sõna RESTful omadussõnana). Selle API aluseks on HTTP protokolli meetodite laialdane kasutamine. Selles lähenemuses kasutatakse GET meetodit andmete hankimiseks, POST meetodit andmete loomiseks, PUT meetodit andmete muutmiseks ja DELETE meetodit - andmete kustutamiseks.
Näiteks vaatleme mõnd API-d, mis manipuleerib kasutajatega. Vaatame, kuidas URL-id erinevate tegevuste jaoks välja näevad.
Kõikide kasutajate hankimine:
GET http://api.loc/users/
Ühe kasutaja hankimine tema id järgi:
GET http://api.loc/user/1/
Kasutaja loomine:
POST http://api.loc/user/
Kasutaja muutmine tema id järgi:
PUT http://api.loc/user/1/
Kasutaja kustutamine tema id järgi:
DELETE http://api.loc/user/1/
Oletame, et teil on veebipoe toodete API. Kirjeldage poe URL-id nii, et API-st saaks RESTful.
