Send hendelser til ditt eget system med webhooks

En webhook lar IDup ringe en nettadresse av deg i det øyeblikket noe skjer, for eksempel når en faktura er betalt. Hver levering er signert og gjentas hvis systemet ditt ikke svarer.

Legg til et endepunkt

1. Åpne Webhooks fane og trykk Legg til endepunkt.
2. Skriv inn en Navn og URL. Den må være offentlig tilgjengelig. Adresser innenfor et privat nettverk blir avvist av sikkerhetsgrunner.
3. Hake av Hendelser du ønsker.
4. Valgfritt: velg en API-nøkkel. Endepunktet mottar da kun hendelser som denne nøkkelen kan lese.
5. Trykk Lagre. IDup viser Din signeringshemmelighet én gang. Lagre den trygt.

Hendelser

• Faktura opprettet, Faktura betalt, Betaling mottatt
• Ny kunde, Ny kontakt, Nytt lead, Ny billett
• Tilbud akseptert — et tilbud som en kunde har akseptert

Hver levering har tre overskrifter: hendelsesnavnet, et leveringsnummer og signaturen. Et nytt forsøk beholder samme leveringsnummer, slik at systemet ditt kan gjenkjenne duplikater.

Sjekk signaturen

Systemet ditt bør beregne en HMAC-SHA256 over tiden og råkroppen med din hemmelighet, sammenligne det med signaturen, og avvise en tid eldre enn 5 minutter. Trykk Verifiser signatur og eksempler for ferdiglaget kode.

Test, pause og forny

• Send test sender en testhendelse og viser HTTP-koden og tiden det tok.
• Pause stopper leveranser; Aktiver starter dem igjen.
• Rull hemmelighet oppretter en ny hemmelighet. Den gamle slutter å fungere umiddelbart.
• Slett fjerner endepunktet. Loggen beholdes.

Forsøk og loggen

Din adresse må svare med en 2xx-kode innen 5 sekunder. Omdirigeringer følges ikke. Hvis det mislykkes, prøver IDup igjen etter 1 minutt, 5 minutter, 30 minutter, 2 timer og 12 timer. Etter sjette forsøk markeres leveringen Gitt opp.

Loggen viser hvert forsøk med hendelse, endepunkt, forsøk, HTTP-kode, varighet og starten på svaret. Status er Venter, Levert, Mislyktes eller Gitt opp. Bruk Send på nytt for å sende en levering igjen.