Gdzie to znaleźć
Otwórz menu organizacji na dole paska bocznego, kliknij Zarządzaj, a potem kartę Webhooki. Zobaczysz swoje webhooki i przycisk Dodaj webhook.Dodaj webhook
1
Otwórz okno
Kliknij Dodaj webhook (albo Utwórz pierwszy webhook, jeśli lista jest pusta).
2
Nazwa i adres
Wpisz Nazwa * oraz Adres URL punktu końcowego *, na przykład
https://your-server.com/webhooks/zippendo. Użyj adresu zaczynającego się od https://.3
Wybierz zdarzenia
Zaznacz Zdarzenia *, których potrzebujesz, takie jak Wysłano przesyłkę lub Zaktualizowano status śledzenia, albo kliknij Zaznacz wszystkie.
4
Zapisz
Kliknij Utwórz webhook. Zippendo wysyła teraz każde wybrane zdarzenie na Twój adres. Twój serwer powinien szybko odpowiedzieć statusem 2xx, żeby Zippendo wiedziało, że wiadomość dotarła.
Każda wiadomość zawiera nazwę zdarzenia, czas oraz szczegóły przesyłki, zamówienia lub śledzenia. Dokładną zawartość i sposób sprawdzania podpisu znajdziesz w Szybkim starcie z webhookami.
Zabezpieczanie webhooków
- Podpis: Zippendo podpisuje każdą wiadomość sekretem należącym do webhooka. Twój programista używa go, by sprawdzić, że wiadomość naprawdę pochodzi od Zippendo. Aplikacja nie pokazuje sekretu; programista odczytuje go przez API (żądanie Get webhook w dokumentacji API).
- HTTPS: używaj tylko adresów
https://, żeby wiadomości były szyfrowane w drodze.
Marki
Jeśli Twoja organizacja korzysta z marek, możesz przypisać webhookowi markę. Wtedy otrzymuje on tylko zdarzenia tej marki. Webhook bez marki otrzymuje zdarzenia wszystkich marek. Ustaw Marka podczas dodawania lub edycji webhooka.Wstrzymaj lub usuń webhook
- Wstrzymanie: kliknij Edytuj przy webhooku, odznacz Aktywna i kliknij Zapisz zmiany. Zippendo przestaje wysyłać wiadomości na ten adres, ale zachowuje webhook i jego Dziennik dostarczeń.
- Usunięcie: kliknij Usuń, wpisz nazwę webhooka wielkimi literami i potwierdź. Na ten adres nie będą już wysyłane żadne wiadomości, a jego Dziennik dostarczeń zostanie usunięty.