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:

urlGET http://api.loc/users/

Gauname vieną vartotoją pagal jo id:

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

Sukuriame vartotoją:

urlPOST http://api.loc/user/

Keičiame vartotoją pagal jo id:

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

Triname vartotoją pagal jo id:

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