Ugrás a tartalomra

Folyamatintegráció / 11

Webhookok fogadása. Üzleti műveletek megbízható végrehajtása.

Esemény érkezik, amelynek a következő rendszerben műveletet kell kiváltania. Többszörös kézbesítés, késés vagy kiesett cél-API esetén ebből üzemeltetési folyamat lesz. Egyértelmű eseményekkel és ellenőrizhető hatásokkal fejlesztjük ezt a működést.

Műszaki feladat ismertetésePélda megtekintése
Webhookok · HMACQueue · DeduplikálásReplay · Üzemállapot

Kiinduló helyzet

A HTTP 200 önmagában nem bizonyít végrehajtott üzleti folyamatot.

Egy webshop rendelési eseményt küld. Az ERP átmenetileg nem elérhető. Ha minden munka a webhook-requesten belül történik, egy időtúllépés ismételt kézbesítést válthat ki; azonnali visszaigazolás esetén viszont elveszhet a rendelés.

Elkülönítjük az ellenőrzött átvételt a későbbi feldolgozástól. A küldő határozza meg az aláírás formátumát és kézbesítési szabályokat. Az integráció definiálja a deduplikálást, megőrzést és a sikeres visszaigazolás jelentését.

A DataSource feladatai

Fogadás, tartós tárolás és célművelet elkülönítése.

Bemenet védelme

Aláírás ellenőrzése a küldő dokumentációja szerint az eredeti request-bájtokon. Méret, Content-Type és támogatott eseménytípusok korlátozása.

Tartós átvétel

Esemény mentése egyeztetett védett tárolóba vagy queue-ba. A megfelelő HTTP-sikerjelzés visszaadása csak sikeres átvétel után.

Feldolgozás

Egyedi ID-k használata, idempotens hatások kialakítása és célválaszok ellenőrzése. Tartós hibák külön kezelése és kontrollált replay biztosítása.

Műszaki forgatókönyv / szemléltető példa

Átvétel visszaigazolása, feldolgozás külön követése.

Szemléltető payload. Az eventId és orderId különböző azonosítók. Az ismételt kézbesítés nem eredményezhet szükségszerűen új rendelést; a feldolgozás sikere külön állapot.

Példaadatok és javasolt szabályok. A konkrét interfészeket és üzleti szabályokat a projektjéhez ellenőrizzük.

Példa / esemény
{
  "eventId": "evt-1042",
  "type": "order.approved",
  "orderId": "ORD-8421",
  "version": 3
}

verified → persisted → accepted
worker   → effect checked → processed

Hibakezelés, biztonság és üzemeltetés

Dupla kézbesítés és részleges hibák.

01

Duplikátumok és összeomlás

Az esemény-ID önmagában nem elegendő, ha a worker a célművelet és visszaigazolás között leáll. Az üzleti hatáshoz is ismétlés elleni védelem vagy célrendszeri egyeztetés szükséges.

02

Sorrend

Nem minden küldő garantálja a sorrendet. A verziók vagy aktuális célállapot megakadályozzák, hogy egy késő esemény visszaállítson egy újabb állapotot.

03

Replay

Hibaállapot, javítás és ismételt végrehajtás követhető nyilvántartása. A payload személyes adatokat tartalmazhat; a tárolást és hozzáférést tudatosan korlátozzuk.

Szakmai kérdések

Részletek, amelyek a megvalósítás előtt számítanak.

Webhookok · HMAC · Queue · Deduplikálás · Replay · Üzemállapot

Garantált az exactly-once feldolgozás?

Több rendszeren keresztül ez nem általános ígéret. Ismételt kézbesítéssel tervezünk, és olyan feldolgozással, amelynek üzleti hatása biztonságosan egyeztethető.

Mindig a teljes rekordot kell tárolnunk?

Csak a feldolgozáshoz és egyeztetett hibahivatkozáshoz szükséges adatokat. A megőrzés és hozzáférés az üzemeltetési koncepció része.

Mi a teendő, ha a küldő nem ad esemény-ID-t?

Megbízható kulcs létrehozható az erőforrásból, verzióból és eseménytípusból. Egy egyszerű payloadhash nem automatikusan üzletileg egyedi esemény.

A műszaki egyeztetéshez

A konkrét folyamatból indulunk ki.

Kérjük, készítse elő a küldő aláírás-, retry- és eseménydokumentációját, anonimizált payloadokat és kívánt célműveleteket. Az ismert többszörös kézbesítések segítik a hibakezelési koncepciót.

Az első beszélgetésen tisztázzuk az elérhető hozzáféréseket, az adatfelelősséget és egy körülhatárolt első adatfolyamot. Ezután egyeztetjük a terjedelmet, felelősségi köröket és feltételeket.

Beszéljük meg a projektet

A kezdéshez anonimizált példák elegendők. Az első megkeresésben kérjük, ne küldjön jelszavakat, tokeneket vagy személyes adatokat tartalmazó éles adatokat.

Kapcsolat és időpontfoglalás

Kapcsolódó feladatok

A következő integráció összefüggései.

Platformok

REST API-integráció

A dokumentáció rendelkezésre áll, a tesztkérés működik. A napi működésben mégis hiányoznak adatok vagy duplikált rekordok keletkeznek. A DataSource a konkrét üzleti folyamathoz kapcsolja REST-API-ját, és a válasz elmaradásával is számol.

Adatfolyamatok

Rendelések és állapotok szinkronizálása

A webshop fizetett állapotot jelez, az ERP még nem ismeri a rendelést, a szállításnak már van nyomkövetési száma. Meghatározott állapotokkal, egyértelmű rendelési hivatkozásokkal és tervezett újraindítással kapcsoljuk össze ezeket a lépéseket.

Szolgáltatás: webhookok és folyamatautomatizálás
Műszaki hivatkozások

Hivatalos dokumentáció, ellenőrizve: 2026. október 6. Az alkalmazhatóság az adott telepítéstől és verziótól függ.