Procesní integrace / 11
Přijímejte webhooky. Spolehlivě provádějte obchodní operace.
Přijde událost a má vyvolat akci v dalším systému. Opakované doručení, zpoždění nebo výpadek cílového API z toho dělají provozní proces. Vyvineme jej s jednoznačnými událostmi a ověřitelnými účinky.
Výchozí stav
Samotný HTTP 200 nedokazuje provedený obchodní proces.
Shop odešle událost objednávky. ERP je dočasně nedostupné. Pokud se celá práce provádí ve webhook requestu, timeout může vyvolat nové doručení; při okamžitém potvrzení se může objednávka ztratit.
Oddělujeme ověřené přijetí a následné zpracování. Odesílatel určuje formát podpisu a pravidla doručení. Integrace definuje deduplikaci, uchování a význam úspěšného potvrzení.
Co zajišťuje DataSource
Oddělit příjem, persistenci a cílovou akci.
Zabezpečit vstup
Ověření podpisu podle dokumentace odesílatele nad původními bajty requestu. Omezení velikosti, Content-Type a podporovaných typů událostí.
Trvale přijmout
Uložení události do dohodnutého chráněného úložiště nebo queue. Odpovídající HTTP úspěch vrátit až po úspěšném přijetí.
Zpracovat
Používání jednoznačných ID, idempotentní účinky a ověření cílových odpovědí. Samostatné řešení trvalých chyb a umožnění kontrolovaného replay.
Technický scénář / ilustrativní příklad
Potvrdit přijetí, zpracování sledovat samostatně.
Ilustrativní payload. eventId a orderId jsou různé identity. Opakované doručení nemusí vytvořit novou objednávku; úspěšné zpracování je vlastní stav.
Vzorová data a navržená pravidla. Konkrétní rozhraní a obchodní pravidla se prověří pro váš projekt.
{
"eventId": "evt-1042",
"type": "order.approved",
"orderId": "ORD-8421",
"version": 3
}
verified → persisted → accepted
worker → effect checked → processedOšetření chyb, bezpečnost a provoz
Duplicitní doručení a dílčí chyby.
Duplicity a pád
Samotné ID události nestačí, pokud worker selže mezi cílovou akcí a potvrzením. I obchodní účinek potřebuje ochranu před opakováním nebo porovnání cíle.
Pořadí
Ne každý odesílatel garantuje pořadí. Verze nebo aktuální cílový stav zabraňují tomu, aby opožděná událost vrátila novější stav zpět.
Replay
Dohledatelná evidence chybového stavu, opravy a opětovného provedení. Payloady mohou obsahovat osobní údaje; ukládání a přístup se vědomě omezují.
Odborné otázky
Detaily důležité před implementací.
Webhooky · HMAC · Queue · Deduplikace · Replay · Provozní stav
Je exactly-once garantováno?
Napříč více systémy to není obecný příslib. Plánujeme opakované doručení a zpracování, jehož obchodní účinek lze bezpečně porovnat.
Musíme vždy ukládat celý záznam?
Pouze data potřebná pro zpracování a dohodnutý kontext chyby. Uchování a přístup jsou součástí provozního konceptu.
Co když odesílatel neposkytuje ID události?
Spolehlivý klíč může vzniknout ze zdroje, verze a typu události. Jednoduchý hash payloadu není automaticky obchodně jednoznačná událost.
Pro technické vyjasnění
Začít vaším konkrétním procesem.
Připravte dokumentaci odesílatele k podpisům, retries a událostem, anonymizované payloady a požadované cílové akce. Známá opakovaná doručení pomáhají s chybovým konceptem.
V prvním rozhovoru vyjasníme dostupné přístupy, odpovědnost za data a omezený první datový tok. Poté dohodneme rozsah, odpovědnosti a podmínky.
Pro začátek stačí anonymizované příklady. V prvním dotazu neposílejte hesla, tokeny ani produkční data s osobními údaji.
Související úlohy
Další propojení v kontextu.
Integrace REST API
Dokumentace existuje, testovací request funguje. V běžném provozu přesto chybějí data nebo vznikají duplicitní záznamy. DataSource propojí vaše REST API s konkrétním obchodním procesem a plánuje i případ, kdy odpověď nepřijde.
Synchronizovat objednávky a stavy
Shop hlásí zaplaceno, ERP ještě nezná objednávku a expedice už má tracking číslo. Propojíme tyto kroky s definovanými stavy, jednoznačnými referencemi objednávek a plánovaným obnovením běhu.
Automatizovat uživatele a přístupová práva
Nový zaměstnanec potřebuje přístupy v několika aplikacích. Změna týmu mění role, odchod vyžaduje odebrání. Propojíme autoritativní personální data s kontrolovaným procesem těchto změn.
Technické reference
Oficiální dokumentace, ověřeno 6. října 2026. Vhodnost závisí na konkrétní instalaci.