Čo je REST API?

REST API je architektonický štýl, nie štandard, na budovanie distribuovaných systémov. Je založený na princípoch ako bezstavovosť (statelessness), klient-server architektúra a používanie štandardných HTTP metód (GET, POST, PUT, DELETE, PATCH) pre operácie nad zdrojmi.

Kľúčové princípy REST:

• Bezstavovosť (stateless): Server neukladá informácie o stave klienta medzi požiadavkami. Každá požiadavka obsahuje všetky potrebné informácie.
• Klient-server: Jasné oddelenie medzi klientom a serverom. Každý sa môže vyvíjať nezávisle.
• Cacheovateľnosť: Odpovede môžu byť označené ako cacheovateľné alebo nie, čo zlepšuje výkon.
• Systém v vrstách: Klient nevie, či je priamo pripojený k serveru alebo cez medzi vrstvy.
• Jednotné rozhranie: Štandardizované spôsoby interakcie s zdrojmi. Zahrnuje:
  • Identifikáciu zdrojov (URI)
  • Manipuláciu so zdrojmi cez reprezentácie
  • Samoopisujúce správy
  • Hypermedia ako motor stavu aplikácie (HATEOAS) - stav aplikácie je riadený hypertextovými odkazmi.

Príklad použitia štandardných HTTP metód:

HTTP metóda	Akcia na zdroji (napríklad, /users)	Popis
GET	/users alebo /users/{id}	Získanie zoznamu používateľov alebo konkrétneho používateľa.
POST	/users	Vytvorenie nového používateľa.
PUT	/users/{id}	Kompletná aktualizácia údajov používateľa podľa jeho ID.
PATCH	/users/{id}	Čiastočná aktualizácia údajov používateľa podľa jeho ID.
DELETE	/users/{id}	Vymazanie používateľa podľa ID.

REST API sa používa na komunikáciu medzi rôznymi systémami a aplikáciami, napríklad medzi frontendom a backendom.