REST API HTTP protokole
Paprastai kuriant svetaines duomenų gavimui, sukūrimui, pakeitimui ir ištrynimui naudojami tik GET ir POST metodai, kadangi juos gerai palaiko naršyklės ir serveriai. Tas pats taikomas ir API, kuriuos teikia svetainės. Tačiau egzistuoja specialūs metodai, standartizuojantys API bendram patogumui tiek API kūrėjams, tiek jo naudotojams.
Vienas iš metodų yra REST API (dažnai vartojamas žodis RESTful kaip būdvardis). Šio API pagrindas yra plačias HTTP protokolo metodų naudojimas. Šiame metode naudojant GET metodą gaunami duomenys, naudojant POST metodą sukuriami, naudojant PUT metodą keičiami, o naudojant DELETE metodą - trinami.
Pavyzdžiui, panagrinėkime kokį nors API, valdantį vartotojus. Pažiūrėkime, kaip atrodys URL įvairiems veiksmams.
Gauname visus vartotojus:
GET http://api.loc/users/
Gauname vieną vartotoją pagal jo id:
GET http://api.loc/user/1/
Sukuriame vartotoją:
POST http://api.loc/user/
Keičiame vartotoją pagal jo id:
PUT http://api.loc/user/1/
Triname vartotoją pagal jo id:
DELETE http://api.loc/user/1/
Tarkime, kad turite internetinės parduotuvės produktų API. Aprašykite parduotuvės URL taip, kad API taptų RESTful.