Co je webhook
Webhook je automatický HTTP požadavek, který jedna aplikace pošle druhé ve chvíli, kdy nastane konkrétní událost. Jakmile se zaplatí objednávka, zaregistruje uživatel nebo doběhne sestavení, zdrojový systém odešle malou zprávu, obvykle ve formátu JSON, na adresu, kterou určíte. Vaše aplikace ji přijme a hned zareaguje.
Podstatný je směr. U běžného volání API se vaše aplikace ptá druhého systému „máš něco nového?“ pořád dokola. U webhooku vám druhý systém sám dá vědět ve chvíli, kdy se něco změní. Proto se webhookům říká obrácené API nebo událostní push.
Lidsky řečeno
Představte si, že čekáte na balík. Dotazování (polling) API je jako volat každých deset minut na depo a ptát se, jestli už dorazil. Webhook je kurýr, který zazvoní u dveří přesně ve chvíli, kdy balík přiveze. Neplýtváte voláními a dozvíte se o tom hned.
Kdy se webhooky hodí
- Reakce v reálném čase. Pošlete upozornění do Slacku, když selže platba, nebo spusťte proces po odeslání formuláře.
- Propojení nástrojů. Stripe, GitHub i většina automatizačních platforem používají webhooky k propojení služeb bez vlastního dotazování.
- Úspora zdrojů. Žádné bombardování API na časovač. Událost dorazí jen tehdy, když je co hlásit.
Při nastavení dáte zdrojovému systému adresu (endpoint) a vyberete, které události chcete odebírat. Od té chvíle vám systém posílá data na váš endpoint pokaždé, když taková událost nastane.
Na co si dát pozor
- Na veřejnou adresu může poslat kdokoli. Ověřte, že je každý webhook pravý, obvykle podpisem, který odesílatel přiloží. Bez této kontroly může útočník události podvrhnout.
- Doručení není zaručené. Síť selhává a váš server může být nedostupný. Počítejte s opakovaným odesláním, ošetřete, že tatáž událost dorazí dvakrát (zpracování udělejte idempotentní), a doručení rychle potvrďte odpovědí 200.
- Pomalé zpracování způsobí timeout. Odesílatel vám dává jen pár vteřin. Příjem hned potvrďte a náročnou práci odložte na pozadí.
Související články
- Co je API? - Širší způsob, jak spolu aplikace komunikují a který webhook obrací.
- Co je to API klíč? - Jak systémy prokazují, kdo jsou, když se navzájem volají.
- Automatizace firemních procesů s AI agenty - Kam událostní spouštěče jako webhooky v automatizaci patří.
Chcete být o krok napřed?
Nenechte si utéct naše nejlepší postřehy. Žádný spam, jen praktické analýzy, pozvánky na exkluzivní eventy a shrnutí podcastů přímo do vaší schránky.