API

API (Application Programming Interface, tedy rozhraní pro programování aplikací) je domluvený způsob, jak si dva programy mezi sebou předávají data. Zatímco běžný web je určený lidem a zobrazuje barevné stránky, API je určené strojům a posílá holá data, obvykle ve formátu JSON nebo XML.

Představte si okénko na poště. Nemusíte vědět, co se děje vzadu ve skladu – stačí podat lístek s číslem zásilky a dostanete odpověď. API je přesně takové okénko: jsou daná pravidla, na co se smíte zeptat a co přijde zpátky, a zbytek Vás nemusí zajímat.

Kde na API narazíte v praxi:

• Doprava – e-shop se přes API dopravce zeptá, kde je balík, a zákazníkovi to rovnou ukáže.
• Platby – platební brána přes API potvrdí obchodu, že platba dorazila.
• Mapy a počasí – prvek na stránce si tahá aktuální údaje z cizí služby.
• Kurzy měn nebo sklad – účetní program si v noci sám stáhne data a nikdo nic nepřepisuje ručně.

Technicky se dotaz posílá stejným protokolem HTTP jako běžná stránka, jen na adresu určenou pro data. Volání se skoro vždy chrání API klíčem – dlouhým tajným řetězcem, který zastupuje heslo. S klíčem zacházejte opatrně: patří do konfigurace na serveru, nikdy do JavaScriptu, který si může kdokoli zobrazit v prohlížeči.

Pro majitele webu jsou důležité dvě věci. Když se rozbije něco „na dálku" (nezobrazuje se doprava, nechodí objednávky do účetnictví), bývá na vině právě API druhé strany. A každé volání stojí čas – pomalé cizí rozhraní umí zpomalit celou stránku, proto se odpovědi často ukládají do cache. Chyby volání se zapisují do chybového logu.