Vysvětlete principy a hlavní ideologii RESTful API

RESTful API je architektonický styl pro tvorbu webových služeb založený na principech REST (Transfer of Representational State). Hlavní myšlenky:

• Zdroje: Všechno, s čím API pracuje, je prezentováno jako zdroje (například uživatelé, produkty), které jsou identifikovány unikátními URI.

• HTTP metody: Pro interakci se zdroji se používají standardní HTTP metody:

  • GET — získat data o zdroji;
  • POST — vytvořit nový zdroj;
  • PUT — aktualizovat zdroj;
  • DELETE — odstranit zdroj.

• Stavové kódy: Odpovědi serveru obsahují HTTP stavové kódy, které informují o výsledku operace (například 200 OK, 404 Nenalezeno).

• Bezstavovost (stateless): Každý požadavek od klienta na server musí obsahovat všechny potřebné informace, server neukládá stav mezi požadavky.

• Caching: Odpovědi mohou být ukládány do cache pro zvýšení výkonu.

• Jednotné rozhraní: Usnadňuje interakci a pochopení API.

Příklad požadavku na RESTful API pro získání seznamu uživatelů:

GET /users HTTP/1.1
Host: example.com
Accept: application/json

Odpověď:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

Tímto způsobem RESTful API zajišťuje jednoduchou, srozumitelnou a standardizovanou komunikaci mezi klientem a serverem.