Systémy, které si předají
správná data.

Začínám mapováním dat: pojmenuji zdroje, cíle, vlastníka jednotlivých údajů a pravidla, podle kterých se pozná úplný a platný záznam.

Co API integrace skutečně řeší

Firmy často používají několik nástrojů, které samy o sobě fungují dobře, ale jejich data zůstávají oddělená. Objednávka se zapíše na jedno místo, stav se ručně přepíše do druhého a report vzniká z kopie tabulky.

API integrace může přenášet nové záznamy, synchronizovat stav, připravovat podklady nebo spouštět navazující úlohy. Smyslem není propojit všechno se vším. Smyslem je odstranit konkrétní ruční předávání a přitom zachovat kontrolu.

Webhook, polling, nebo dávka?

Webhook dává smysl, když zdroj umí oznámit změnu okamžitě a cílový systém ji dokáže bezpečně přijmout. Polling se hodí, když potřebujeme pravidelně kontrolovat stav a rozhraní neposkytuje události. Dávkové zpracování bývá praktičtější u reportů, velkých objemů nebo procesů, kde nevadí zpoždění.

Volba závisí na limitech API, dostupnosti historie, očekávaném objemu a na tom, co se má stát, když je cílový systém dočasně nedostupný. Rychlejší přenos nemusí být lepší, pokud neumí bezpečně zopakovat nedokončenou operaci.

Mapování dat je důležitější než počet endpointů

Stejný zákazník může mít v různých systémech jiný identifikátor. Stav „odesláno“ nemusí znamenat totéž co „uzavřeno“. Datum může být uložené v jiném časovém pásmu. Právě tyto rozdíly rozhodují o tom, zda integrace šetří práci, nebo jen přesouvá chyby do dalšího místa.

• určím zdroj pravdy pro každý důležitý údaj,
• popíšu převod názvů, formátů a stavů,
• ověřím povinná pole a neúplné záznamy,
• definuji, co se stane při konfliktu,
• zajistím dohledatelnost přenosu bez ukládání zbytečně citlivých dat.

Co musí přežít výpadek

Externí služba může vrátit chybu, odpovědět pozdě nebo potvrdit požadavek až po přerušení spojení. Proto odděluji odeslání od vyhodnocení výsledku, ukládám stav úlohy a opakuji jen operace, u kterých je to bezpečné.

Součástí návrhu může být fronta, omezení rychlosti, klíč idempotence, upozornění na neúspěšné přenosy a přehled, který ukáže, kde se integrace zastavila. Cílem je, aby se problém dal opravit bez ručního dohledávání v několika systémech.

Jak integraci předávám

1. Mapa systému: zdroje, cíle, odpovědnosti a datové vazby.
2. Ověření rozhraní: oprávnění, limity, testovací prostředí a změnová pravidla.
3. První směr: jeden konkrétní přenos s měřitelným výsledkem.
4. Provoz: logy, opakování, upozornění, dokumentace a postup pro ruční opravu.

Co se tím zlepší

Dobrá integrace nevytvoří jen další technickou vrstvu. Zmenší počet ručních přepisů, zpřesní odpovědnost za data a zkrátí hledání chyby. Tým zároveň ví, které údaje jsou aktuální, které čekají na zpracování a kdo může problém vyřešit.

Pokud je proces nejasný nebo se jeho pravidla často mění, doporučím nejprve upravit pracovní postup. Integrovat nejasnost znamená jen rychleji šířit nejasná data.