Co je API a k čemu je firmě: propojení systémů lidsky
API je rozhraní, přes které spolu mluví programy. Díky němu se objednávka z e-shopu sama propíše do fakturace a poptávka z webu do CRM, aniž by ji někdo přepisoval. Pro firmu je to rozdíl mezi systémy, které spolupracují, a ostrůvky, mezi kterými kopírujete data ručně.
Aktualizováno
API jako číšník
Nejčastější přirovnání: v restauraci nejdete do kuchyně, ale řeknete číšníkovi, co chcete, a on vám to přinese. Nemusíte vědět, jak kuchyně funguje, stačí znát jídelní lístek. API je takový číšník mezi programy – a dokumentace API je jídelní lístek, který říká, o co si lze říct a v jaké podobě přijde odpověď.
Většina dnešních webových služeb používá API ve stylu REST: program pošle požadavek na určitou adresu a dostane odpověď ve formátu JSON, tedy strukturovaná data, se kterými umí pracovat jiný program.
Kde se s API setkáte ve firmě
| Propojení | Co se děje automaticky |
|---|---|
| Web → CRM | Odeslaná poptávka se založí jako kontakt a obchodní příležitost |
| E-shop → fakturace | Z objednávky vznikne faktura, po zaplacení se označí jako uhrazená |
| Rezervace → kalendář | Termín z webu se objeví v kalendáři pracovníka |
| E-shop → dopravce | Zásilka se sama nahlásí a zákazník dostane číslo pro sledování |
| Web → e-mailing | Kdo se přihlásí k odběru, přibude do seznamu příjemců |
Praktické příklady propojení s účetními programy rozebírá článek napojení webu na účetnictví, cestu poptávky od formuláře až do CRM popisuje automatické zpracování poptávek.
Webhook: když se systém ozve sám
Klasické API funguje na dotaz: „máš nové objednávky?“ Webhook je opačný směr – systém sám pošle zprávu, jakmile se něco stane („právě přišla platba“). Pro firmu to znamená, že na sebe navazující kroky proběhnou hned, ne až při příští kontrole.
Na co si dát pozor
- API klíče jsou jako hesla. Patří na server, ne do kódu, který si může kdokoli zobrazit v prohlížeči. Každé propojení má mít vlastní klíč s nejnižšími potřebnými oprávněními, aby šel v případě úniku zrušit samostatně.
- Limity. Služby omezují, kolik požadavků smíte poslat za určitou dobu. Propojení s velkým množstvím dat musí s limity počítat, jinak se v nejrušnější chvíli zastaví.
- Změny na druhé straně. Poskytovatelé API čas od času vydávají nové verze a staré vypínají. Někdo musí propojení hlídat a udržovat.
- Chyby a výpadky. Dobré propojení počítá s tím, že druhá strana chvíli neodpovídá, a data neztratí – zkusí to znovu nebo upozorní člověka.
Než si koupíte nový software
Pět otázek, které se vyplatí položit dodavateli:
- Má systém veřejné API a je k němu dokumentace?
- Je přístup k API v ceně, nebo jen ve vyšším tarifu?
- Umí systém posílat webhooky při důležitých událostech?
- Dostanu svá data kdykoli celá ven v běžném formátu?
- Napojuje se na systémy, které už používám, hotovým doplňkem?
Pokud systém API nemá a data z něj nejdou dostat, budete na něm závislí. Kdy se vyplatí místo krabicového softwaru vlastní řešení, popisuje heslo webová aplikace.
Jak to děláme my
Na API stojí i náš vlastní provoz: poptávka odeslaná z webu se sama objeví jako kontakt a příležitost v našem CRM, zároveň odejde upozornění a potvrzovací e-mail zákazníkovi. Stejná propojení stavíme klientům. Web, který posílá data do CRM, stavíme ve variantě Web na míru (35 000 Kč); propojení dalších systémů vždy nejdřív naceníme a teprve pak se pouštíme do práce. Hodina navíc stojí 1 000 Kč.
Časté otázky
Co znamená zkratka API?
Application Programming Interface, česky aplikační programové rozhraní. Je to dohodnutý způsob, jakým si jeden program řekne jinému o data nebo mu zadá úkol.
Potřebuji programátora, abych API využil?
Na propojení dvou systémů obvykle ano, nebo nástroj, který propojení umí bez programování pro běžné případy. Jako majitel firmy ale nemusíte API rozumět technicky – stačí vědět, jestli ho systémy, které používáte, mají a co přes ně jde.
Je API bezpečné?
Tak bezpečné, jak se s ním zachází. Přístup se chrání klíči nebo přihlášením, má mít jen taková oprávnění, jaká propojení opravdu potřebuje, a klíče nesmí být vidět ve veřejném kódu webu.
Co když systém API nemá?
Pak zbývá import a export souborů, případně ruční přepisování. Pro malé objemy to může stačit, ale vždy je to pomalejší a náchylnější k chybám. Při výběru nového softwaru je proto otázka na API jedna z nejdůležitějších.