REST API HTTP protokolā
Parasti, veidojot vietnes, datu iegūšanai, izveidošanai, mainīšanai un dzēšanai tiek izmantotas tikai metodes GET un POST, jo tās labi tiek atbalstītas pārlūkprogrammās un serveros. Tas pats attiecas arī uz API, ko nodrošina vietnes. Tomēr pastāv īpašas pieejas, kas standartizē API vispārējai ērtībai gan API izstrādātājiem, gan tā lietotājiem.
Viena no pieejām ir REST API (bieži saka RESTful, lietojot šo vārdu kā īpašības vārdu). Šī API pamatā ir plaša HTTP protokola metožu izmantošana. Šajā pieejā ar GET metodi tiek iegūti dati, ar POST metodi tiek izveidoti dati, ar PUT metodi tiek mainīti dati, bet ar DELETE metodi - dzēsti.
Piemēram, apskatīsim kādu API, kas manipulē ar lietotājiem. Apskatīsim, kā izskatīsies URL dažādām darbībām.
Iegūstam visus lietotājus:
GET http://api.loc/users/
Iegūstam vienu lietotāju pēc viņa id:
GET http://api.loc/user/1/
Izveidojam lietotāju:
POST http://api.loc/user/
Mainām lietotāju pēc viņa id:
PUT http://api.loc/user/1/
Dzēšam lietotāju pēc viņa id:
DELETE http://api.loc/user/1/
Pieņemsim, ka jums ir interneta veikala produktu API. Aprakstiet veikala URL tā, lai API kļūtu par RESTful.