Skip to main content
Webhooki informują Twoje systemy w chwili, gdy coś dzieje się w Zippendo, na przykład gdy przesyłka zostaje wysłana albo zmienia się status śledzenia. Dzięki temu Twój sklep internetowy lub system ERP jest na bieżąco, bez ciągłego odpytywania API.
Webhooki są wliczone w każdy plan.

1. Dodaj webhook

1

Otwórz Webhooki

W app.zippendo.com otwórz menu organizacji na dole paska bocznego, kliknij Zarządzaj, a potem Webhooki.
2

Utwórz webhook

Kliknij Dodaj webhook. Wpisz Nazwa i Docelowy adres URL, zaznacz Zdarzenia, które chcesz otrzymywać, i kliknij Utwórz webhook.
3

Pobierz klucz podpisu

Zippendo tworzy klucz podpisu dla każdego webhooka. Aplikacja go nie pokazuje: odczytasz go przez API z GET /orgs/{orgId}/webhooks/{webhookId} albo z odpowiedzi, gdy tworzysz webhook przez API za pomocą POST /orgs/{orgId}/webhooks. Przechowuj go na swoim serwerze i weryfikuj podpis przy każdym dostarczeniu.

2. Zdarzenia

Zamówienia zaimportowane z kanału sprzedaży nie wysyłają zdarzeń order.*. Wyślij test przy webhooku wysyła zdarzenie webhook.test na ten jeden adres.

3. Zasady dostarczania

Każde dostarczenie to żądanie HTTPS POST z treścią JSON w postaci { "event", "timestamp", "brandId", "data" } i trzema nagłówkami: Dostarczenie wygasa po 10 sekundach. Każda odpowiedź inna niż 2xx lub przekroczenie czasu liczy się jako niepowodzenie, a Zippendo próbuje ponownie z rosnącą przerwą: łącznie do 5 prób. Każda próba, udana lub nie, jest widoczna w Dziennik dostarczeń webhooka w sekcji Webhooki.

4. Obsługa dostarczeń

Twój adres docelowy powinien:
  • Szybko odpowiadać statusem 2xx, a ciężką pracę wykonywać w tle
  • Używać HTTPS
  • Weryfikować podpis, zanim zaufa treści
  • Bezpiecznie obsługiwać ponowienia: użyj X-Webhook-Id, aby pominąć dostarczenie, które już przetworzono

5. Testuj w trakcie tworzenia

Użyj tunelu (na przykład ngrok), aby nadać serwerowi deweloperskiemu publiczny adres HTTPS, taki jak https://your-tunnel.ngrok.io/webhooks/zippendo. Skieruj na niego testowy webhook i kliknij Wyślij test.

Następne kroki

Przewodnik po webhookach

Edytuj, wstrzymuj i usuwaj webhooki oraz czytaj dziennik dostarczeń.

REST API

Łącz webhooki z wywołaniami API, gdy potrzebujesz danych na żądanie.