Wyślij zdarzenia do własnego systemu za pomocą webhooków

Webhook pozwala IDup wywołać Twój adres internetowy w momencie, gdy coś się dzieje, na przykład gdy faktura zostanie opłacona. Każda dostawa jest podpisana i powtarzana, jeśli Twój system nie odpowiada.

Dodaj punkt końcowy

1. Otwórz Webhooki zakładka i naciśnij Dodaj punkt końcowy.
2. Wprowadź Nazwa i URL. Musi być publicznie dostępny. Adresy wewnątrz sieci prywatnej są odrzucane ze względów bezpieczeństwa.
3. Zaznacz Wydarzenia czego potrzebujesz.
4. Opcjonalnie: wybierz Klucz API. Punkt końcowy otrzymuje tylko zdarzenia, do których ten klucz ma dostęp.
5. Naciśnij Zapisz. IDup pokazuje Twój tajny klucz podpisu raz. Przechowuj go bezpiecznie.

Wydarzenia

• Faktura utworzona, Faktura opłacona, Płatność otrzymana
• Nowy klient, Nowy kontakt, Nowy lead, Nowy zgłoszenie
• Oferta zaakceptowana — oferta zaakceptowana przez klienta

Każda dostawa zawiera trzy nagłówki: nazwę wydarzenia, numer dostawy i podpis. Ponowienie ma ten sam numer dostawy, więc system może rozpoznać duplikaty.

Sprawdź podpis

System powinien obliczyć HMAC-SHA256 z czasem i surowym ciałem przy użyciu sekretu, porównać go z podpisem i odrzucić czas starszy niż 5 minut. Naciśnij Zweryfikuj podpis i przykłady dla gotowego kodu.

Testuj, wstrzymaj i odnów

• Wyślij test wysyła wydarzenie testowe i pokazuje kod HTTP oraz czas, jaki to zajęło.
• Pauza zatrzymuje dostawy; Aktywuj uruchamia je ponownie.
• Sekret rolki tworzy nowy sekret. Stary przestaje działać natychmiast.
• Usuń usuwa punkt końcowy. Jego dziennik jest zachowany.

Ponowne próby i log

Twój adres musi odpowiedzieć kodem 2xx w ciągu 5 sekund. Przekierowania nie są śledzone. Jeśli się nie powiedzie, IDup próbuje ponownie po 1 minucie, 5 minutach, 30 minutach, 2 godzinach i 12 godzinach. Po szóstej próbie dostawa jest oznaczona Poddać się.

Dziennik pokazuje każdą próbę z wydarzeniem, punktem końcowym, próbą, kodem HTTP, czasem trwania i początkiem odpowiedzi. Status to Oczekiwanie, Dostarczono, Niepowodzenie lub Poddać się. Użyj Ponowne wysłanie wysłać ponownie dostawę.