Logo David Burdelak
Słownik · Web development

Co to jest webhook?

Ostatnia aktualizacja:

Webhook to mechanizm, w którym jedna usługa automatycznie wysyła żądanie HTTP pod wskazany adres, gdy zajdzie określone zdarzenie, na przykład nowe zamówienie lub płatność. Odbiorca nie musi sam odpytywać o zmiany.

Jak działa webhook?

Rejestrujesz adres swojej aplikacji w usłudze. Gdy pojawia się zdarzenie, usługa wysyła tam żądanie POST z danymi, zwykle w formacie JSON, a aplikacja je przetwarza.

Webhook a API

W API to klient pyta o dane, kiedy ich potrzebuje. W webhooku to serwer sam wysyła dane, gdy coś się zmieni, co zmniejsza liczbę zbędnych zapytań.

Jak zabezpieczyć webhook?

Weryfikuj podpis żądania (np. HMAC) lub sekretny token, akceptuj tylko HTTPS i szybko odpowiadaj kodem 200, a ciężką obróbkę przenoś do kolejki.

Niezawodność webhooków

Usługi wysyłające webhooki zwykle ponawiają żądanie, jeśli nie dostaną odpowiedzi z kodem 2xx, więc ten sam komunikat może dotrzeć kilka razy. Obsługa powinna być idempotentna: zapisz identyfikator zdarzenia i pomiń powtórki. Warto też logować przychodzące żądania i mieć sposób na ponowne przetworzenie zdarzeń, które się nie powiodły.

To jeden z elementów, które decydują o tym, kiedy warto wybrać headless CMS zamiast tradycyjnego systemu.

Zobacz w praktyce

Powiązane pojęcia

Wszystkie hasła z kategorii Web development