Co je to API?

API (Application Programming Interface)

API neboli Application Programming Interface zkráceně jen rozhraní slouží pro komunikaci dvou nebo více systémů. V kontextu propojování informačních systémů nebo webových aplikací se používá pro standardizovanou komunikaci mezi dvěma systémy. V jednom ze systémů se zpravidla implementuje API, které nabízí potřebné funkce. Tyto funkce API se následně přesně zdokumentují a popíšou v technické dokumentaci rozhraní a na základě dokumentace se pak v druhém systému implementuje používání těchto funkcí. Pomoci takto implementovaného rozhraní můžou pak dva samostatné systémy spolu komunikovat automaticky a bez zásahu člověka, a aniž by byly napsané v tom samém programovacím jazyce nebo používali kompatibilní technologie.

Jak můžete API využít v praxi?

Dnes již existuje řada online služeb a velké množství z nich nabízí API pro propojení. Můžete tak mít jednu službu pro fakturaci, jinou pro vedení účetnictví, e-shop, online platby, správu zákazníků, newsletter a tak dále a všechny můžou navzájem komunikovat a posílat si data.

Pak, když například zákazník nakoupí ve Vašem e-shopu, e-shop vytvoří fakturu v online fakturační službě, přidá vytvořenou fakturu do účetnictví, vytvoří objednávku ve Vašem ERP systému, přidá zákazníka do Vašeho CRM a zařadí ho do spamlistu ve službě pro newsletter. To vše přes API, online, automaticky a bez Vašeho dalšího zásahu.

API lze také použít pro automatické objednávání přepravy zásilek jak píšu zde, nebo pro automatizovaný sběr objednávek od obchodních partnerů jak popisuji zde.

Jaké technologie mohou být použity?

V oblasti webových aplikací se pro implementaci API často používá standardní HTTP protokol. Rozhraní se pak používá vzdáleně, prováděním standardních HTTP dotazů na jednotlivé URL adresy (endpointy / funkce) rozhraní. Vstupní data pro danou funkci rozhraní se odešlou v dotazu na daný URL endpoint. Výsledek zpracování pak odešle HTTP server zpátky klientovi v odpovědi na provedený dotaz. Pro výměnu dat se při tom nejčastěji používá formát XML nebo JSON.

Obecně můžeme ale o rozhraní mluvit například také při spouštění programů přes příkazovou řádku operačního systému, kdy spustíme program s nějakými vstupnými parametry a program jako odpověď vypíše výstup do příkazového řádku (toto lze provést také v programu a nahlížet tak na příkazovou řádku jako na API operačního systému). Rozhraní ale také nabízí například softwarová knihovna případně framework, kdy v daném programovacím jazyku používáme a voláme se vstupními parametry jednotlivé funkce dané knihovny. Na webu pak jakákoliv webová stránka používá rozhraní webového serveru, kdy frontend (internetový prohlížeč) komunikuje s backendem (webovým serverem) pomocí standardního HTTP protokolu a server odpovídá daty ve formátu HTML - tedy XML.

Michal Strelec,