Webhook: zdarzenia, podpis i historia dostarczeń
Webhook wysyła zdarzenie na podany adres. Sprawdź podpis i historię dostarczeń.
Przed rozpoczęciem
- Zaloguj się do panelu właściwej firmy.
- Masz uprawnienie do ustawień API i przygotowane środowisko TEST.
Przykład
Webhook TEST o nowym zamówieniu trafia na https://example.com/webhooks/navyflame. Sekret nie jest pokazany w instrukcji.
Krok po kroku
- 01
Przygotuj odbiornik
Utwórz adres HTTPS w swojej aplikacji, który przyjmuje zdarzenia. Testuj na danych przykładowych.
Po tym kroku: Adres odpowiada na połączenie.
- 02
Dodaj webhook
W Konto, API otwórz Webhooki i wybierz Nowy webhook. Wskaż typ zdarzenia oraz adres.
Po tym kroku: Subskrypcja pokazuje właściwy typ i cel.
- 03
Zapisz sekret
Sekret podpisu skopiuj przy tworzeniu i przechowuj bezpiecznie. Odbiornik powinien weryfikować podpis przed zapisem danych.
Po tym kroku: Nie przyjmujesz niepotwierdzonego żądania.
- 04
Wyślij test i sprawdź historię
Użyj Testuj. Otwórz historię dostarczeń i odczytaj kod odpowiedzi oraz czas. Przy błędzie popraw odbiornik i ponów.
Po tym kroku: Dostarczenie testowe ma wynik 2xx.
Sprawdź wynik
Testowy webhook jest dostarczony, a odbiornik sprawdza podpis.
Jeśli nie widzisz wyniku
Jeśli historia pokazuje błąd, sprawdź certyfikat HTTPS, odpowiedź serwera i czas przetwarzania. Nie wyłączaj weryfikacji podpisu.
Ważne
Po rotacji sekretu zaktualizuj odbiornik i sprawdź dostarczenie testowe.
Potrzebujesz pomocy? Otwórz Wsparcie w panelu swojej firmy i opisz, na którym kroku pojawił się problem.
Jak zgłosić problem