Skip to main content
Webhook sprawia, że Zippendo informuje inny system o zdarzeniu, takim jak Wysłano przesyłkę lub Zaktualizowano status śledzenia. Webhooki konfigurujesz w Ustawienia → Webhooki (otwórz menu organizacji i kliknij Zarządzaj). Dla każdego zdarzenia Zippendo wysyła wiadomość na Docelowy adres URL, który wpisałeś. To nie są webhooki śledzenia przewoźników. O nich przeczytasz w Webhooki śledzenia przewoźników.

​
Co widzisz

  • Twój system niczego nie otrzymuje.
  • Dziennik dostarczeń webhooka pokazuje czerwone kody statusu lub tekst w kolumnie Błąd.
  • Twój system otrzymuje to samo zdarzenie więcej niż raz.

​
Najpierw sprawdź dziennik dostarczeń

W Webhooki kliknij Dziennik dostarczeń przy webhooku. Każdy wiersz to jedna próba, z kolumnami Zdarzenie, Status (odpowiedź Twojego systemu), Czas trwania i ewentualnym Błąd.
  • Brak dostarczeń: Zippendo nie próbowało jeszcze niczego wysłać. Zobacz „Nic nie jest wysyłane” poniżej.
  • Zielony status: Twój system odebrał wiadomość. Szukaj problemu we własnym systemie.
  • Czerwony status albo b.d. z błędem: Twój system nie przyjął wiadomości. Zobacz „Dostarczenia kończą się niepowodzeniem” poniżej.

​
Nic nie jest wysyłane

​
Dostarczenia kończą się niepowodzeniem

Zippendo uznaje dostarczenie za udane tylko wtedy, gdy Twój system odpowie statusem sukcesu (200-299) w ciągu 10 sekund. W przeciwnym razie próbuje jeszcze kilka razy w ciągu około minuty, łącznie 5 prób. Potem zdarzenie nie jest już wysyłane. Gdy usuniesz przyczynę, kliknij Wyślij test przy webhooku. Zobaczysz Wysłano zdarzenie testowe, a w Dziennik dostarczeń pojawi się nowy wiersz.
Zippendo nie wysyła ponownie nieudanych zdarzeń później. Jeśli Twój system przez jakiś czas nie działał, wyszukaj pominięte przesyłki lub zamówienia w aplikacji Zippendo albo pobierz je przez API.

​
Twój system odrzuca podpis

Każda wiadomość ma nagłówek X-Webhook-Signature, dzięki któremu Twój system może sprawdzić, że naprawdę pochodzi od Zippendo. To HMAC-SHA256 surowej treści wiadomości, utworzony za pomocą sekretu webhooka. Typowe błędy:
  • Podpis jest liczony z wiadomości po jej sparsowaniu i przepisaniu, zamiast z surowej treści dokładnie w takiej postaci, w jakiej została odebrana.
  • Używany jest sekret innego webhooka. Każdy webhook ma własny sekret.
Szczegóły i przykłady kodu: Szybki start z webhookami.

​
To samo zdarzenie przychodzi dwa razy

Jeśli Twój system odpowiedział zbyt wolno lub z błędem, Zippendo próbuje ponownie, nawet jeśli Twój system obsłużył pierwszą próbę. Użyj nagłówka X-Webhook-Id, aby rozpoznać wiadomość, którą już obsłużyłeś. Powiązane: Webhooki, Ustawienia webhooków.