Co je to REST API?

REST API je architektonický styl, nikoliv standard, pro stavbu distribuovaných systémů. Je založen na principech, jako je bezstavovost (statelessness), klient-server architektura a používání standardních HTTP metod (GET, POST, PUT, DELETE, PATCH) pro operace nad zdroji.

Klíčové principy REST:

• Bezstavovost (stateless): Server neukládá informace o stavu klienta mezi požadavky. Každý požadavek obsahuje všechny potřebné informace.
• Klient-server: Jasné oddělení mezi klientem a serverem. Každý se může vyvíjet nezávisle.
• Cacheovatelnost: Odpovědi mohou být označeny jako cacheovatelné nebo ne, což zlepšuje výkon.
• Systém v vrstvách: Klient nemůže vědět, jestli je připojen přímo ke serveru nebo přes mezivrstvu.
• Jednotné rozhraní: Standardizované způsoby interakce s zdroji. Zahrnuje:
  • Identifikaci zdrojů (URI)
  • Manipulaci se zdroji přes reprezentace
  • Samoopisující zprávy
  • Hypermedia jako motor stavu aplikace (HATEOAS) - stav aplikace je řízen hypertextovými odkazy.

Příklad použití standardních HTTP metod:

Metoda HTTP	Akce na zdroji (například /users)	Popis
GET	/users nebo /users/{id}	Získání seznamu uživatelů nebo konkrétního uživatele.
POST	/users	Vytvoření nového uživatele.
PUT	/users/{id}	Kompletní aktualizace dat uživatele podle jeho ID.
PATCH	/users/{id}	Částečná aktualizace dat uživatele podle jeho ID.
DELETE	/users/{id}	Odstranění uživatele podle ID.

REST API se používá pro komunikaci mezi různými systémy a aplikacemi, například mezi frontendem a backendem.