Tato sekce je určena pro konzumenty mluvii Public API a má poskytnout detail k použití a manipulaci s webhooky, a tím přispět ke snadnější implementaci integrací se systémy 3. stran.
Po jak dlouhé době dochází ke smazání webhooku?
Nefunkční webhook je smazán po 3 dnech, během kterých se nedaří doručit zprávu na definované URL.
Co když se nepodaří webhook poslat na URL?
V takovém případě se vyvolá (až 2x) retry. Když ani to nestačí, zpráva se zahodí.
Platí pravidlo "one event at a time"?
Ano, 1 webhook = 1 request
Jak poznáte, že data chodí skutečně z mluvii?
Do URL je možné přidat username:password [dle rfc-3986 (3.2.1. User Information)] ,které transformujete do Authorize hlavičky, takže je možné provést basic authentication.
Jsou ošetřeny případy duplicitních eventů (např. 2x zrušení objednávky)?
TCP protokol potvrzuje doručení a HTTP protokol definuje potvrzovací odpověď klientského serveru. V případě výpadku (klient zpracuje payload od mluvii před tím, než k nám pošle http odpověď) posílá mluvii stejný payload znovu. Zpracování payloadu klientem by mělo být idempotentní operace.
Odchází informace o jednotlivých eventech ve správném pořadí?
Ano, události pro daný typ entity (sezení, e-mail, user) odcházejí v pořadí, v jakém nastanou.
Je vyžadováno použití HTTPS protokolu pro webhook endpointy?
Je to doporučeno, ačkoli to v dnešní době nevynucujeme.
