REST API v protokole HTTP
Spravidla pri tvorbe webových stránok na získavanie, vytváranie, zmenu a mazanie údajov sa používajú iba metódy GET a POST, pretože sú dobre podporované prehliadačmi a servermi. To isté platí aj pre API poskytované webovými stránkami. Existujú však špeciálne prístupy, ktoré štandardizujú API pre všeobecné pohodlie ako vývojárov API, tak aj jeho používateľov.
Jedným z prístupov je REST API (často sa hovorí RESTful, pričom sa toto slovo používa ako prídavné meno). Základom tohto API je široké používanie metód protokolu HTTP. V tomto prístupe sa pomocou metódy GET získavajú údaje, pomocou metódy POST sa vytvárajú, pomocou metódy PUT sa menia a pomocou metódy DELETE - mazania.
Napríklad, pozrime sa na nejaké API, ktoré manipuluje s používateľmi. Pozrime sa, ako budú vyzerať URL pre rôzne akcie.
Získame všetkých používateľov:
GET http://api.loc/users/
Získame jedného používateľa podľa jeho id:
GET http://api.loc/user/1/
Vytvoríme používateľa:
POST http://api.loc/user/
Zmeníme používateľa podľa jeho id:
PUT http://api.loc/user/1/
Odstránime používateľa podľa jeho id:
DELETE http://api.loc/user/1/
Nech máte API produktov internetového obchodu. Popíšte URL obchodu tak, aby sa API stalo RESTful.