API: Pevný základ softwaru na míru

Ve firmách nic neběží samo – ERP, CRM, e-shop, sklady i logistika vyžadují rychlé a bezpečné předávání dat. Základem pro snadný přenos je API. Co se skrývá za třemi písmeny, které zcela jistě potkáte při vývoji softwaru na míru?

Co je to API?

API (Application Programming Interface) představuje způsob předávání dat mezi systémy. Pro vývojáře softwaru na míru jde o efektivní metodu, pomocí které lze využít konkrétní funkci. Jednoduše řečeno – jde o sadu pravidel, která říká:

• Jak se má systém zeptat („pošli data“, „udělej tuto akci“).
• Kde se má zeptat (adresa, endpoint).
• V jakém formátu mají být data (JSON, XML, protobuf a další).
• Co dostane uživatel zpět (odpověď + stavový kód).
• Kdo má k datům přístup (autentizace a autorizace).

Pokud má vývojářská firma přístup k API, nepotřebuje znát detaily systému. Stačí jí k tomu informace o tom, jak se ptát a jaké odpovědi očekávat. Tato pravidla stanovuje API ve formě jasně definovaných polí popsaných v dokumentaci.

API představuje také kontrakt. Je to smlouva a předem definovaná dohoda, která definuje vstupy, výstupy, oprávnění a limity. Některé API požadavky jsou proto zpoplatněné.

Fungování API v praxi

Vlastní aplikace na míru nejčastěji využívají HTTP API – přístup přes web. Vedle toho ale existují i další formy jako knihovny nebo operační systémy. Webové API funguje dvěma směry:

• Klient odešle request na endpoint – web pošle požadavek na adresu (např. „Dej mi detail objednávky.“)
• Server odpovídá (vrátí response) – vrátí data a informace o tom, jak požadavek dopadl.

Ne vždy se požadavek API setká s úspěchem. Server proto v rámci výsledků požadavků odesílá zprávy, které tazateli sdělují výsledek. V rámci webového API se uživatelé setkávají s těmito odpověďmi.

Výhody API při vývoji softwaru na míru

Díky API nestaví vývojářská firma jeden monolit, ale kompletní ekosystém. API je způsob, jak se ze softwaru stane jeden fungující celek bez ručního přepisu a neustálé exportu a importu dat. Dobře navržené API navíc usnadňuje integraci aplikací třetích stran. 

API funguje jako lepidlo mezi dvěma systémy, a proto se využívá v různých typech softwaru:

• ERP
• CRM
• E-shopy
• Sklady
• Doprava
• BI/reporting

Co znamená API při vývoji softwaru na míru? Jeden systém – více kanálů. Web, mobilní aplikace, partnerské weby, B2B systém a interní aplikace využívají stejné rozhraní. Všechny aplikované změny jsou navíc levnější a rychlejší.

Co když API neexistuje?

Dva systémy se propojí i bez API, dá to ale mnohem více práce. Komunikace vyžaduje ruční vstupy, systém je křehčí a hůře se kontroluje. Integrace aplikací třetích stran vypadá tak, že se obcházejí chybějící rozhraní různými náhradami.

• Každá změna bolí – bez API neexistuje stabilní kontrakt. Pokud se něco změní, integrace se rychle hroutí.
• Horší bezpečnost a audit – náhrady typu přímý vstup do databáze nebo sdílené účty se hůře hlídají.
• Nižší spolehlivost a více chyb – při ručních přenosech vznikají duplicity, překlepy, špatné mapování a importní chyby.
• Systém nefunguje v reálném čase – spousta náhradních integrací funguje dávkově a stahuje se např. jen jednou za den.

U malého množství dat dává smysl i napojení bez API. Při vývoji softwaru se využívá v případě nízké frekvence změn. Bez API si vystačí i firmy, které nepotřebují neustále aktuální data.

Pokud nelze využít API napojení, systémy často využívají export/import – zasílání a čtení datových balíčků. V některých případech lze využít i screen scraping, kdy naprogramovaný robot kliká v uživatelském rozhraní.

API je pevný základ, díky kterému firemní software funguje čistě, bezpečně a s minimem ručních vstupů. Dobře navržená API dokumentace usnadňuje integrace aplikací třetích stran a umožňuje lepší škálování celého softwarového ekosystému.