REST API a HTTP protokollban

Általában weboldalak készítésekor az adatok lekéréséhez, létrehozásához, módosításához és törléséhez csak a GET és POST metódusokat használják, mivel ezeket jól támogatják a böngészők és a szerverek. Ugyanez vonatkozik az API-kra is, amelyeket a weboldalak kínálnak. Léteznek azonban különleges megközelítések, amelyek szabványosítják az API-kat az általános kényelem érdekében, mind az API fejlesztői, mind a felhasználói számára.

Az egyik ilyen megközelítés a REST API (gyakran mondják RESTful-nak, ezt a szót melléknévként használva). Ennek az API-nak az alapja a HTTP protokoll metódusainak széleskörű használata. Ebben a megközelítésben a GET metódussal lekérik az adatokat, a POST metódussal hozzák létre, a PUT metódussal módosítják, a DELETE metódussal pedig törlik.

Példaként vizsgáljunk meg egy API-t, amely felhasználókkal manipulál. Nézzük meg, hogyan néznek ki a URL-ek a különböző műveletekhez.

Összes felhasználó lekérése:

urlGET http://api.loc/users/

Egy felhasználó lekérése a id alapján:

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

Felhasználó létrehozása:

urlPOST http://api.loc/user/

Felhasználó módosítása a id alapján:

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

Felhasználó törlése a id alapján:

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