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
Headless CMS - kiedy warto porzucić monolityczny CMS
Błąd 405 (Method Not Allowed) - co oznacza i jak go naprawić?
Jak naprawić błędy certyfikatu SSL i mixed content