Webhooki — konfiguracja¶
Strona techniczna (podpis, format, ponowienia) jest w dokumentacji API. Tutaj: jak to ustawić z panelu.
Dodanie¶
Ustawienia → Webhooki → Dodaj:
- Adres — musi być HTTPS i osiągalny z internetu.
localhostnie zadziała. - Zdarzenia — zaznacz tylko te, które faktycznie obsługujesz. Nadmiar to zbędny ruch po obu stronach.
- Sekret — zapisz go; posłuży do weryfikacji podpisu po Twojej stronie.
Sprawdzenie, że działa¶
Przycisk Testuj wysyła próbne żądanie. Jeśli Twój serwer odpowie kodem 2xx, połączenie jest sprawne.
Historia doręczeń przy każdej subskrypcji pokazuje, co i kiedy poszło oraz jakim kodem odpowiedział Twój serwer. To pierwsze miejsce do sprawdzenia, gdy „webhooki nie działają” — zwykle widać tam 404 (zły adres) albo 500 (błąd po stronie odbiorcy).
Typowe pomyłki¶
| Objaw | Najczęstsza przyczyna |
|---|---|
| Nic nie przychodzi | zdarzenie nie jest zaznaczone w subskrypcji |
| Historia pokazuje 404 | literówka w adresie albo zmieniona ścieżka po Twojej stronie |
| Historia pokazuje 401/403 | Twój serwer odrzuca żądanie — sprawdź weryfikację podpisu |
| Podpis się nie zgadza | liczysz HMAC z przetworzonego JSON-a zamiast z surowej treści żądania |
Podpis licz z surowego ciała żądania
Odczytanie JSON-a i ponowne zserializowanie zmienia białe znaki i kolejność kluczy — podpis przestaje się zgadzać. Weź bajty tak, jak przyszły.