Co je to RESTful API a jaké má vlastnosti?

RESTful API je architektonický styl pro tvorbu webových služeb, který využívá principy REST (Transfer of Representational State). Hlavní znaky RESTful API:

• Klient-serverová architektura: klient a server jsou odděleni, což jim umožňuje nezávisle se vyvíjet.

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

• Cacheovatelnost: odpovědi serveru by měly jasně uvádět, zda je možné je uložit do cache, což zvyšuje výkon.

• Jednotné rozhraní: použití standardních HTTP metod (GET, POST, PUT, DELETE atd.) pro operace s prostředky.

• Identifikace prostředků: prostředky jsou identifikovány přes URL (například /uživatelé/123).

• Vícevrstvý systém: architektura může mít několik úrovní (proxy, load balancery), aniž by to ovlivnilo interakci mezi klientem a serverem.

Příklad požadavku na RESTful API v C# s použitím HttpClient:

using System.Net.Http;
using System.Threading.Tasks;

HttpClient client = new HttpClient();

// Získání uživatele s id=123
HttpResponseMessage response = await client.GetAsync("https://api.priklad.cz/uzivatele/123");
string content = await response.Content.ReadAsStringAsync();

// obsah obsahuje údaje uživatele ve formátu JSON

Tímto způsobem je RESTful API postaveno kolem zdrojů a standardních HTTP operací, zajišťující jednoduchost a škálovatelnost.