Znalosti pro vibe coding
Co je webhook?
Zpráva, kterou služba sama pošle vaší appce, jakmile se něco stane. API voláte vy. Webhook volá vás.
Autor: Jindřich Fáborský · 17 let v marketingu · 2 000+ hodin vibe codingu · 180+ projektů
Ve službě se něco stane
💳 Platba proběhla
POST na vaši URL
vaseappka.cz/api/webhook
→ appka rovnou zareaguje
Rychlá odpověď
Co je tedy webhook?
Webhook je zpráva, kterou vám služba pošle sama, jakmile u ní nastane nějaká událost. Předem jí řeknete adresu vaší appky a ona na ni v ten okamžik pošle data.
Je to druhá strana API. API si zavoláte, když něco potřebujete. Webhook zavolá vás, když se něco stane. Proto se mu říká i „obrácené API“.
Pojmy, na které kolem toho narazíte:
Na co to je
Webhook už znáte. Teď k čemu ho využít?
Appka z vibe codingu málokdy žije sama. Jakmile začne spolupracovat s další službou, je webhook to, co jí v reálném čase dá vědět, že se něco stalo. Tři případy přímo z praxe.
Platba proběhla
Stripe pošle webhook, vaše appka podle něj potvrdí objednávku a pošle přístup. Takhle u nás na aifirst.cz potvrzujeme objednávky zaplacené kartou.
Nový kód → nasazení
Pushnete kód na GitHub, ten pošle webhook Vercelu a ten web sám nasadí. Proto je změna online do pár minut.
E-mail doručen, nebo ne
Resend umí poslat webhook, když se e-mail doručí nebo odrazí. Appka tak pozná, komu zpráva nedošla.
A jak to funguje uvnitř
Kolik dotazů to ušetří
API voláte vy. Webhook volá vás. Bez něj by se appka musela pořád dokola ptát „už je to?“ (tomu se říká polling). Spusťte obě cesty vedle sebe a uvidíte ten rozdíl.
Postaru: polling
pořád se ptáteVaše appka se každou chvíli ptá služby: „už proběhla platba?“
S webhookem
služba zavolá vásVaše appka mlčky čeká. Služba se ozve sama v okamžiku platby.
Na co si dát pozor
Webhook URL je veřejná. Ověřte podpis.
Webhook URL musí být dostupná z internetu, aby na ni služba mohla posílat zprávy. To ale znamená, že by na ni teoreticky mohl poslat zprávu i někdo cizí a předstírat třeba, že proběhla platba.
Proto seriózní služby každou zprávu podepíšou tajným klíčem. Stripe třeba přidává podpis do hlavičky (HMAC-SHA256 z obsahu a vašeho klíče). Vaše appka podpis ověří, a když nesedí, zprávu zahodí.
Dvě pravidla pro klid
- 1.Vždy ověřte podpis. Bez ověření věříte komukoli, kdo zná vaši URL. Claude Code vám ověření do endpointu napíše.
- 2.Klíč patří do proměnných prostředí. Podpisový klíč nikdy nedávejte do kódu. Kam s ním, řeší průvodce Environment variables.
Když spolu appky mluví, běží samy
Webhooky, API, platby, deploy. Jakmile propojíte pár služeb, vznikne appka, co běží sama. Přesně tohle skládáme v kurzu AI First, polopaticky a na reálných příkladech.
21 hodin videí o AI a vibe codingu, 1 800+ absolventů, roční licence s aktualizacemi zdarma.
FAQ
Časté otázky
Co je webhook jednoduše řečeno?+
Webhook je zpráva, kterou vám nějaká služba automaticky pošle, jakmile se u ní něco stane. Předem jí dáte adresu (webhook URL) vaší appky a ona na ni v okamžiku události pošle data. Třeba Stripe vám dá echo „platba proběhla“, GitHub „přišel nový kód“.
Jaký je rozdíl mezi webhookem a API?+
Je to stejná technologie z opačné strany. API voláte vy, když něco potřebujete („dej mi počasí“). Webhook volá vás, když se něco stane u služby. Proto se webhooku říká reverse API neboli obrácené API. API si berete, webhook dostáváte.
Co je webhook URL a payload?+
Webhook URL je adresa u vaší appky, na kterou má služba posílat zprávy (třeba vaseappka.cz/api/webhook). Payload je obsah té zprávy, tedy data o události ve formátu JSON. Když proběhne platba, v payloadu je částka, číslo objednávky a podobně.
Jak zabezpečím webhook, aby mi někdo neposlal falešnou událost?+
Webhook URL je veřejně dostupná, takže by na ni teoreticky mohl poslat zprávu kdokoli a předstírat třeba zaplacení. Proto služby zprávu podepisují tajným klíčem a vy podpis ověříte. Když nesedí, zprávu zahodíte. Ten klíč patří do proměnných prostředí, nikdy do kódu.
Kde webhook nastavím?+
V nastavení té služby. U Stripe je to sekce Webhooks, kde vyplníte svou webhook URL a vyberete, o kterých událostech chcete dostávat zprávy. Vaše appka musí mít endpoint, který tu zprávu přijme a zpracuje.
Musím webhook programovat sám?+
Přijímací endpoint ve vaší appce vám Claude Code klidně napíše, včetně ověření podpisu. Když nechcete psát vůbec nic, webhooky umí i no-code nástroje jako Zapier nebo Make: chytnou událost z jedné služby a předají ji jinam. Pro vlastní appku je ale vlastní endpoint čistší.
Co je to polling a proč je webhook lepší?+
Polling znamená, že se vaše appka služby pořád dokola ptá „už je hotovo?“. Zbytečně tím zatěžuje server a novinku se stejně dozví opožděně. Webhook pošle jednu zprávu přesně v okamžiku události. Míň provozu a v reálném čase.