Trimiteți evenimente către propriul sistem cu webhooks

Un webhook permite IDup să apeleze o adresă web a dumneavoastră în momentul în care se întâmplă ceva, de exemplu când o factură este plătită. Fiecare livrare este semnată și repetată dacă sistemul dumneavoastră nu răspunde.

Adăugați un punct final

1. Deschideți Webhooks tab și apăsați Adăugați punct final.
2. Introduceți un Nume și URL. Trebuie să fie accesibil publicului. Adresele dintr-o rețea privată sunt refuzate din motive de securitate.
3. Bifați Evenimente doriți.
4. Opțional: alegeți un Cheie API. Endpoint-ul primește apoi doar evenimentele pe care această cheie le poate citi.
5. Apăsați Salvați. IDup arată Secretul dumneavoastră de semnare o dată. Păstrați-o în siguranță.

Evenimente

• Factură creată, Factură plătită, Plată primită
• Client nou, Contact nou, Client potențial nou, Tichet nou
• Ofertă acceptată — o ofertă pe care un client a acceptat-o

Fiecare livrare are trei anteturi: numele evenimentului, un număr de livrare și semnătura. O retrimitere păstrează același număr de livrare, astfel încât sistemul dumneavoastră să poată recunoaște duplicatele.

Verificați semnătura

Sistemul dumneavoastră ar trebui să calculeze un HMAC-SHA256 peste timp și corpul brut cu secretul dumneavoastră, să-l compare cu semnătura și să refuze un timp mai vechi de 5 minute. Apăsați Verificare semnătură și exemple pentru cod gata făcut.

Testați, întrerupeți și reînnoiți

• Trimiteți testul trimite un eveniment de test și arată codul HTTP și timpul necesar.
• Pauză oprește livrările; Activați le pornește din nou.
• Secretul rolei creează un nou secret. Cel vechi încetează să mai funcționeze imediat.
• Ștergeți elimină punctul final. Jurnalul său este păstrat.

Reîncercări și jurnalul

Adresa dumneavoastră trebuie să răspundă cu un cod 2xx în termen de 5 secunde. Redirecționările nu sunt urmate. Dacă eșuează, IDup încearcă din nou după 1 minut, 5 minute, 30 de minute, 2 ore și 12 ore. După a șasea încercare, livrarea este marcată Renunțat.

Jurnalul arată fiecare încercare cu eveniment, punct final, încercare, cod HTTP, durată și începutul răspunsului. Statusul este Așteptare, Livrat, Eșuat sau Renunțat. Folosiți Retrimiteți pentru a trimite din nou o livrare.