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 HTTPSPOST 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 jakhttps://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.