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:

urlGET http://api.loc/users/

Získame jedného používateľa podľa jeho id:

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

Vytvoríme používateľa:

urlPOST http://api.loc/user/

Zmeníme používateľa podľa jeho id:

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

Odstránime používateľa podľa jeho id:

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