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:
GET http://api.loc/users/
Egy felhasználó lekérése a id alapján:
GET http://api.loc/user/1/
Felhasználó létrehozása:
POST http://api.loc/user/
Felhasználó módosítása a id alapján:
PUT http://api.loc/user/1/
Felhasználó törlése a id alapján:
DELETE http://api.loc/user/1/
Tegyük fel, hogy van egy internetes bolt termékeinek API-ja. Írja le a bolt URL-jeit úgy, hogy az API RESTful legyen.