Webhook

Webhook je automatizovaná zpráva odeslaná z aplikace ve chvíli, kdy nastane určitá událost. Tato zpráva je doručena na konkrétní URL adresu ve formě HTTP požadavku (typicky typu POST) a obvykle obsahuje data ve formátu JSON.

Abychom pochopili přínos Webhooku, musíme ho srovnat s tradičním dotazováním:

• Polling (API): Vaše aplikace se každých 5 minut ptá: „Mám nový e-mail? … A teď? … A teď?“. To plýtvá výkonem a zdroji.
• Webhook: Vaše aplikace jen čeká. Jakmile e-mail dorazí, server odesílatele pošle zprávu: „Tady je nový e-mail!“ přímo na vaši adresu.

Celý proces se skládá ze tří jednoduchých kroků:

1. **Registrace:** V nastavení aplikace (např. GitHub, Stripe, Discord) zadáte svou **Payload URL** (cílovou adresu vašeho skriptu).
2. **Událost (Event):** V aplikaci nastane změna (např. někdo zaplatil fakturu nebo přidal komentář).
3. **Odeslání (POST):** Zdrojová aplikace okamžitě pošle HTTP POST požadavek na vaši URL s podrobnostmi o události.

Webhooky jsou základem moderní automatizace a propojenosti služeb:

• E-shopy: Po zaplacení objednávky pošle platební brána (Stripe/PayPal) Webhook vašemu systému, který automaticky změní stav objednávky na „Zaplaceno“.
• CI/CD: Jakmile vývojář pošle kód do Gitu, GitHub pošle Webhook serveru, který okamžitě spustí testování a nasazení aplikace.
• Komunikace: Když se ve vašem systému objeví kritická chyba, Webhook pošle upozornění přímo do kanálu v Slacku nebo Discordu.

Protože je vaše URL veřejně dostupná na internetu, mohl by na ni kdokoli poslat falešná data. Proto se používají tyto metody ochrany:

• Tajný klíč (Secret): Zdrojová aplikace k datům přidá digitální podpis (HMAC). Vy si ověříte, že podpis odpovídá vašemu klíči.
• Whitelist IP adres: Povolíte příjem požadavků pouze z oficiálních adres dané služby.

Typický Webhook vypadá jako text ve formátu JSON. Například upozornění na novou zprávu:

{
  "event": "message.created",
  "sender": "Jan Novak",
  "text": "Ahoj, posilam podklady k projektu.",
  "timestamp": "2025-12-28T15:52:00Z"
}

Tip: Pro testování Webhooků bez nutnosti psát kód můžete použít nástroje jako Webhook.site nebo Beeceptor. Ty vám vygenerují dočasnou URL, na které uvidíte přesný obsah zpráv, které vám jiné aplikace posílají.

Zpět na Rozcestník