Udalosti
Enterprise webhooky
Nastavíte Enterprise odber udalostí alebo pull režim a viete, ako overiť doručenie a obnoviť spracovanie.
Predpoklady
- webhooks:write na vytvorenie odberu aj potvrdenie udalostí a webhooks:read na ich čítanie; pri centrálnom partnerskom JWT aj X-Firm-Id oprávnenej firmy.
Odber alebo pull
- Vytvorenie odberu a Node.js príklad overenia podpisu
- Pull fronta: odpoveď a potvrdenie udalostí
- Obnova terminálneho doručenia
Vytvorte odber udalostí
POST /api/v1/webhooks s HTTPS url a events vytvorí push odber; url: null vytvorí pull-only odber. Aj pull vyžaduje vytvorenie odberu. Zariaďte ho pred testovacou operáciou: historické udalosti sa spätne nedopĺňajú. Secret bezpečne uložte, zobrazuje sa iba raz.
Overte doručenie
X-Webhook-Timestamp je Unix čas v sekundách. X-Webhook-Signature je sha256=<64 lowercase hex>; HMAC-SHA256 počítajte nad timestamp + '.' + rawBody pred parsovaním JSON. Overte odchýlku najviac 300 sekúnd a podpis porovnajte v konštantnom čase; funkčný príklad je v pripojenej referencii.
Dorovnajte stav po výpadku
Pri pull odbere čítajte GET /api/v1/events/pull (limit najviac 100), ukladajte udalosti a až po commite potvrďte event_id cez POST /api/v1/events/{eventId}/ack. Pri has_more=true pokračujte. Ak odber v čase udalosti neexistoval, rekonštruujte stav z dokumentov; pri zlyhanom push doručení použite históriu doručení a dead-letter replay podľa referencie.
Hranice Enterprise udalostí
- Enterprise udalosti nie sú náhradou Connector webhooku; kontrakty, secrete aj testy zostávajú oddelené.
- Nezamieňajte udalosť o doručení s obchodnou odpoveďou druhej strany.
Očakávaný výsledok
Máte funkčný odber alebo pull a viete, kedy je doklad doručený a kedy iba prijatý na spracovanie.
Keď to nefunguje
- Udalosť nechodí: overte, či odber vznikol a či callback prešiel overením podpisu.
- Udalosť prišla pred uložením dokladu: po uložení dorovnajte stav čítaním.