Udalosti
Webhooky
Vyberiete správny webhook kontrakt pre svoje rozhranie namiesto jedného zmiešaného postupu.
Predpoklady
- Zvolené rozhranie: SAPI, Connector alebo Enterprise API.
Rozcestník
| Rozhranie | Dostupný mechanizmus | Detail |
|---|---|---|
| Connector | Natívny Connector webhook a práca s udalosťami dokladov. | Connector webhooky |
| Enterprise API | Odbery udalostí a pull režim podľa vydaného kontraktu. | Enterprise webhooky |
| SAPI | Príjem cez SAPI; outbound stav cez Enterprise status/events s providerDocumentId. | Stavy dokumentov |
Čo platí pre všetky udalosti
- Udalosť nie je náhrada vlastného uloženia; spracujte ju idempotentne a overte podpis alebo pôvod.
- Zlyhané doručenie má vlastný obnovovací postup; neposielajte tie isté údaje znovu naslepo.
- Tajomstvá webhooku patria na server, nikdy do browsera.
Očakávaný výsledok
Máte jednu konkrétnu stránku a jeden konkrétny kontrakt pre svoje rozhranie.
Keď to nefunguje
- Udalosti chodia duplicitne: spracovanie musí byť idempotentné, duplicita nie je nový stav.
- Podpis nesedí: overujte nad surovým telom, nie nad znovu serializovaným JSON.