> For the complete documentation index, see [llms.txt](https://docs.mluvii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mluvii.com/pro-it-specialisty/public-api/faq-pro-webhooky.md).

# FAQ pro Webhooky

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)](https://www.rfc-editor.org/rfc/rfc3986)] ,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.