Integrace · 8 minut čtení

Jak propojit firemní systémy pomocí API

Dobrá integrace není jen přenos dat. Musí řešit vlastnictví informace, chyby, opakování, bezpečnost a dohled nad provozem.

Kde integrace nejčastěji pomáhá

Typickým příkladem je přenos objednávek z e-shopu do ERP, synchronizace skladových zásob, předávání dokladů účetnictví, aktualizace zákazníků v CRM nebo napojení platební brány. Cílem je odstranit ruční přepisování a zajistit, aby různé systémy pracovaly se stejnou informací.

Nejdříve určete zdroj pravdy

Pro každý údaj musí být jasné, který systém jej vlastní. Cenu může řídit ERP, kontaktní údaje CRM a stav platby platební brána. Pokud mohou stejnou hodnotu měnit dva systémy bez jasného pravidla, integrace začne vytvářet konflikty.

Co ověřit před vývojem

Synchronně, nebo na pozadí?

Některé operace musí proběhnout okamžitě, například ověření platby. Jiné je bezpečnější zpracovat ve frontě na pozadí. Uživatel pak nemusí čekat na externí systém a neúspěšný požadavek lze automaticky zopakovat.

Integrace musí být pozorovatelná

Bez logů, monitoringu a upozornění může chyba probíhat několik dní bez povšimnutí. Provozní dohled je součást řešení, nikoliv volitelný doplněk.

Bezpečnostní minimum

Přístupové údaje nepatří do zdrojového kódu ani veřejného frontendu. Komunikace musí být šifrovaná, oprávnění omezená na nezbytný rozsah a citlivé hodnoty chráněné v logu. Důležité je také plánovat rotaci klíčů a odebrání přístupu.

Doporučený postup

  1. Zmapovat systémy, vlastníky dat a požadovaný směr toku.
  2. Popsat datové transformace a výjimky.
  3. Ověřit API na malém technickém prototypu.
  4. Navrhnout fronty, opakování a práci s chybami.
  5. Doplnit monitoring a provozní dokumentaci.
  6. Nasadit integraci postupně a porovnat data na obou stranách.
Přepisujete data mezi systémy ručně?

Prověříme dostupná API a navrhneme bezpečný tok dat i první integrační krok.

Probrat integraci