Sprawdź dostarczanie webhooków i napraw błędy

Przeczytaj dziennik dostarczania punktu końcowego webhooka Notiondesk, poznaj ponawianie prób i wstrzymywanie, wznów wstrzymane działanie punktu końcowego i napraw nieudane dostarczanie.

5 min czytania

Każdy punkt końcowy przechowuje dziennik żądań Notiondesk wysłanych do niego. Użyj go, aby sprawdzić, co otrzymał serwer, dlaczego żądanie się nie powiodło i kiedy zostanie ponowiona próba.

Szybka ścieżka: Przejdź do Ustawienia > Deweloperzy > Webhooki , otwórz punkt końcowy i przewiń do sekcji Ostatnie dostawy . Kliknij wiersz, aby zobaczyć odpowiedź i treść żądania.

Przeczytaj ostatnie dostawy

  1. Przejdź do Ustawienia > Deweloperzy > Webhooki .
  1. Kliknij punkt końcowy.
  1. Przewiń do sekcji Ostatnie dostawy .

Lista zawiera 100 najnowszych przesyłek z ostatnich 14 dni. Każdy wiersz zawiera zdarzenie, centrum pomocy, z którego pochodzi (lub obszar roboczy ), wynik i godzinę.

Ikona Status Co to znaczy
Zielony znacznik Dostarczony Twój serwer odpowiedział kodem statusu 2xx
Pomarańczowy zegar Aż do Nie wysłano jeszcze lub oczekuje się na kolejną próbę. Nieudana próba wyświetla wynik, po którym następuje ponowna próba , np. 503.
Czerwony Krzyż Przegrany Każda próba zakończyła się niepowodzeniem. Wiersz pokazuje ostatni wynik.
Szary minus Odwołany Nie wysłano, ponieważ punkt końcowy został wstrzymany lub wyłączony albo jego centrum pomocy nie mogło już odbierać zdarzeń przed kolejną próbą

Otwórz dostawę

Kliknij wiersz, aby go otworzyć:

  • Identyfikator dostawy : taka sama wartość jak w nagłówku X-ND-Delivery, dzięki czemu żądanie można znaleźć w logach serwera.
  • Odpowiedź : kod statusu lub przyczyna błędu, czas oczekiwania serwera i liczba podjętych prób.
  • Treść żądania : dokładny kod JSON, który został wysłany. Kliknij Kopiuj , aby go skopiować.

Treści odpowiedzi nie są przechowywane. W przypadku zdarzeń zawierających dane osobowe, takich jak wiadomości kontaktowe, opinie, członkowie zespołu i prośby o dołączenie, treść żądania jest usuwana po zakończeniu dostarczania.

Ponowne próby

Dostarczenie wiadomości nie powiedzie się, jeśli serwer odpowie kodem statusu innym niż 2xx, dokona przekierowania, nie zacznie odpowiadać w ciągu 5 sekund lub zajmie to łącznie więcej niż 10 sekund. Następnie Notiondesk próbuje ponownie:

Próbować Gdy
1 Zaraz
2 1 minuta po pierwszej próbie
3 10 minut po drugiej próbie
4 1 godzinę po trzeciej próbie
5 6 godzin po czwartej próbie

Po 5 nieudanych próbach dostawa zostanie oznaczona jako Nieudana . Zdarzenia testowe i dostawy oznaczone jako Nieudana próba podpisania nie będą ponawiane.

Gdy wiele zdarzeń ma miejsce jednocześnie, na przykład podczas dużej synchronizacji, przesyłki mogą czekać na wysłanie: zazwyczaj kilka minut, a nawet godzinę, jeśli serwer odpowiada powoli. Pozostają w stanie oczekującym i nie są odrzucane.

Gdy punkt końcowy jest wstrzymany

Notiondesk wstrzymuje działanie punktu końcowego, gdy 10 kolejnych prób dostarczenia zakończyło się niepowodzeniem, a pierwsza z tych awarii miała co najmniej 24 godziny. Zdarzenia testowe nie są liczone.

Gdy punkt końcowy zostanie wstrzymany:

  • Wyświetla komunikat „Wstrzymano” i przestaje odbierać zdarzenia. Próby, które były już zaplanowane, zostają anulowane.
  • Właściciel obszaru roboczego i administratorzy otrzymują jedną wiadomość e-mail zatytułowaną „Punkt końcowy webhook wstrzymany” zawierającą nazwę punktu końcowego, jego hosta i łącze do ustawień webhooka.
  • Wydarzenia z okresu wstrzymania nie są później wysyłane.

Podsumowując:

  1. Napraw swój serwer. Przyczyny awarii w sekcji „Ostatnie dostawy” wskazują, co poszło nie tak.
  1. Kliknij Wyślij zdarzenie testowe i sprawdź, czy jest oznaczone jako Dostarczone .
  1. Kliknij Wznów .

Punkt końcowy zaczyna ponownie odbierać nowe zdarzenia, a zliczanie błędów zaczyna się od nowa.

Jeśli punkt końcowy jest nadal aktywny, ale dostarczanie danych wciąż się nie udaje, na stronie punktu końcowego wyświetla się komunikat Niepowodzenie od wraz z datą pierwszej awarii, jako ostrzeżenie przed wstrzymaniem dostarczania danych.

Napraw nieudane dostawy

Gdy serwer odpowiedział, w wierszu wyświetlany jest kod statusu. W przeciwnym razie wyświetlany jest powód.

Powód Co widzisz Co się stało Jak to naprawić
Status błędu Kod statusu, np. 500 lub 401 Twój serwer odpowiedział błędem Sprawdź logi serwera pod kątem tego czasu. Upewnij się, że punkt końcowy akceptuje żądania POST i że weryfikacja podpisu używa prawidłowego klucza tajnego.
Przekierowanie odrzucone Kod przekierowania, np. 301 lub 302 Twój serwer przekierował żądanie Wprowadź ostateczny adres URL w ustawieniach punktu końcowego
Adres zablokowany Adres zablokowany Twoja domena wskazuje na adres prywatny lub wewnętrzny Skieruj domenę na serwer publiczny
Połączenie nieudane Połączenie nieudane Notiondesk nie mógł połączyć się z Twoim serwerem Sprawdź, czy domena jest rozwiązana, certyfikat TLS jest ważny i port 443 lub 8443 jest otwarty
Przekroczono limit czasu Przekroczono limit czasu Twój serwer nie zaczął odpowiadać w ciągu 5 sekund lub zajęło to ponad 10 sekund Najpierw odpowiedz za pomocą 200, a następnie wykonaj pracę w tle
Podpisywanie nie powiodło się Podpisywanie nie powiodło się Notiondesk nie mógł podpisać żądania To jest po naszej stronie i nie jest powtarzane. Wyślij zdarzenie testowe i skontaktuj się z nami, jeśli problem się powtórzy.

Wyślij zdarzenie testowe

Kliknij „Wyślij zdarzenie testowe” na stronie punktu końcowego, aby wysłać zdarzenie ping do tego punktu końcowego. Pojawi się ono u góry listy ostatnich dostaw .

  • Zdarzenie testowe jest wysyłane raz, bez ponawiania.
  • Możesz wysłać go, gdy punkt końcowy jest wstrzymany, aby sprawdzić poprawkę przed wznowieniem działania.
  • Każda przestrzeń robocza może wysłać do 20 zdarzeń testowych na godzinę. Po przekroczeniu tej liczby pojawi się komunikat „Za dużo zdarzeń testowych. Spróbuj ponownie później”.

Często zadawane pytania

Czy mogę ponownie wysłać przesyłkę, która nie dotarła?

Nie. Otwórz przesyłkę i kliknij Kopiuj, aby uzyskać treść żądania, jeśli chcesz je przetworzyć samodzielnie.

Dlaczego brakuje treści żądania dostawy?

Wydarzenie zawierało dane osobowe, dlatego jego treść została usunięta po zakończeniu transmisji.

Jak długo przechowywane są przesyłki?

14 dni. Ostatnie dostawy pokazują najnowsze 100.

Czy pomyślne zdarzenie testowe wznawia działanie wstrzymanego punktu końcowego?

Nie. Sprawdza tylko Twój serwer. Kliknij Wznów , aby ponownie zacząć odbierać zdarzenia.

Co się stanie ze zdarzeniami w kolejce, jeśli usunę punkt końcowy?

Wiadomości nie są wysyłane, a dziennik dostarczania wiadomości w punkcie końcowym zostaje wraz z nimi usunięty.

Powiązane artykuły

Czy ta strona była pomocna?

Still need help? Ask us