Dzienniki dostarczania i testowanie
Panel ustawień webhooków ma wbudowany dziennik dostarczeń dla każdego endpointu. Używaj go do potwierdzania, że zdarzenia docierają do serwera, diagnozowania błędów i wysyłania nowego przykładowego ładunku bez wywoływania rzeczywistej aktywności.
Przeglądanie dzienników dostarczeń
1
Otwórz Ustawienia → Webhooki
Przejdź do
Dashboard → Settings → Webhooks.2
Rozwiń wiersz webhooka
Kliknij Dzienniki dostarczania przycisk na karcie webhooka. Ostatnie 50 prób w kolejności od najnowszej.
3
Sprawdź każdy wpis
Każdy wiersz pokazuje typ zdarzenia, kod stanu HTTP, czas odpowiedzi, znacznik czasu i ewentualny komunikat o błędzie.
Pola dziennika
| Pole | Opis |
|---|---|
| Zdarzenie | Typ wywołanego zdarzenia (np. post.saved) |
| Status | Status HTTP zwrócony przez punkt końcowy. null przy przekroczeniu czasu lub odmowie połączenia. |
| Czas odpowiedzi | Czas pełnego obiegu w milisekundach od wysłania do ostatniego bajtu odpowiedzi. |
| Sukces | Zielony znacznik = HTTP 2xx. Czerwony krzyżyk = każdy inny wynik. |
| Błąd | Czytelny komunikat o błędzie dla nieudanych dostarczeń (np. Request timed out (10s)). |
| Dostarczono o | Znacznik czasu UTC próby dostarczenia. |
Wysyłanie zdarzenia testowego
1
Rozwiń kartę webhooka
W
Settings → Webhooks, znajdź swój webhook i kliknij Wyślij zdarzenie testowe.2
Sprawdź dziennik dostarczenia
Próba testowa pojawia się u góry dziennika dostarczeń po kilku sekundach. Sprawdź, czy widzisz
200 status.Zdarzenia testowe są prawdziwymi żądaniami HTTP
Zdarzenie testowe przechodzi dokładnie tę samą ścieżkę co rzeczywiste, łącznie z podpisem HMAC. Twój kod weryfikacji podpisu jest więc w pełni sprawdzany.
Brak automatycznego ponawiania
Każde dostarczenie jest podejmowane raz. Dziennik służy tylko do diagnostyki; nie ma przycisku ponownego odtworzenia nieudanego rzeczywistego zdarzenia. Po naprawieniu punktu końcowego użyj funkcji Test, aby sprawdzić poprawkę.
Typowe przyczyny niepowodzeń
| Błąd / status | Prawdopodobna przyczyna | Napraw |
|---|---|---|
Request timed out (10s) | Serwer odpowiadał dłużej niż 10 s | Powrót 200 natychmiast, potem przetwarzaj asynchronicznie |
401 | Weryfikacja podpisu nie powiodła się | Odczytaj surową treść żądania przed parsowaniem JSON |
404 | Ścieżka adresu URL punktu końcowego nie istnieje | Sprawdź ponownie adres URL w ustawieniach webhooków Savebase |
500 | Nieobsłużony błąd w odbiorniku | Sprawdź wyjątek w logach serwera |
| Odmowa połączenia / status null | Serwer nie działa lub URL jest nieprawidłowy | Sprawdź, czy serwer działa i jest publicznie dostępny |