Abychom zajistili stabilitu systému a včas vás upozornili na technické potíže na vaší přijímací straně, DigiSign automaticky monitoruje úspěšnost doručování všech webhooků.
Proč dochází k deaktivaci?
Pokud váš server dlouhodobě neodpovídá (timeout) nebo vrací chybové kódy (jakýkoli jiný než 2xx), systém vyhodnotí webhook jako nefunkční a dočasně jej pozastaví, aby nedocházelo ke zbytečnému vytěžování obou stran.
Podmínky pro automatickou deaktivaci
Webhook je automaticky deaktivován, pokud jsou splněny všechny tyto podmínky:
Nízká úspěšnost: Za posledních 7 dní selhalo více než 75 % volání událostí.
Historie: Webhook byl v systému vytvořen/aktivován před více než 14 dny.
Objem dat: Webhook byl za sledované období provolán více než 10x.
Proces upozornění
Varování: Jakmile systém detekuje problémy, zašle administrátorům pracovního prostoru první e-mailové upozornění s výzvou k opravě (v tuto chvíli webhook zůstává aktivní).
Varování: Pokud nedojde k nápravě do 7 dní od prvního varování, odešle se administrátorům pracovního prostoru druhé e-mailové upozornění s výzvou k opravě (webhook stále zůstává aktivní).
Deaktivace: Pokud nedojde k nápravě ani následujících 7 dní od druhého varování, webhook se deaktivuje a administrátoři obdrží potvrzující e-mail o jeho vypnutí.
Od prvního varování tak máte celkem 14 dní na opravu chybných volání.
Jak obnovit funkčnost deaktivovaného webhooku?
Po opravě chyby na vašem serveru (např. obnova SSL certifikátu nebo navýšení kapacity) můžete jako administrátor webhook v sekci Nastavení > Pro vývojáře > Webhooky ručně přepnout zpět do stavu Aktivní. Sledované období pro deaktivaci se tímto vyresetuje a znovu se začne vyhodnocovat až 14 dní od aktivace.
Přes API webhook znovu aktivujete provoláním endpointu PUT /api/webhooks/{webhookID} s tělem
{
"status": "enabled"
}
💡 TIP: V Detailu webhooku se můžete podívat na jednotlivé pokusy volání a překontrolovat z jakého důvodu se nám nedařilo webhook doručit. Více v našem samostatném článku.