Odeslat události do vašeho vlastního systému pomocí webhooků

Webhook umožňuje IDup zavolat vaši webovou adresu v okamžiku, kdy se něco stane, například když je faktura zaplacena. Každé doručení je podepsáno a opakováno, pokud váš systém neodpovídá.

Přidat koncový bod

1. Otevřít Webhooks záložku a stiskněte Přidat koncový bod.
2. Zadejte Jméno a DPH. URL. Musí být veřejně dosažitelná. Adresy uvnitř soukromé sítě jsou z bezpečnostních důvodů odmítnuty.
3. Zaškrtněte Události chcete.
4. Volitelné: vyberte API klíč. Koncový bod pak přijímá pouze události, které tento klíč může číst.
5. Stiskněte Uložit. IDup zobrazuje Váš podpisový tajný klíč jednou. Uložte jej bezpečně.

Události

• Faktura vytvořena, Faktura zaplacena, Platba přijata
• Nový zákazník, Nový kontakt, Nový lead, Nový tiket
• Nabídka přijata — nabídka, kterou zákazník přijal

Každá zásilka obsahuje tři hlavičky: název události, číslo zásilky a podpis. Opakovaný pokus má stejné číslo zásilky, takže váš systém může rozpoznat duplicity.

Zkontrolovat podpis

Váš systém by měl vypočítat HMAC-SHA256 nad časem a surovým tělem s vaším tajemstvím, porovnat jej s podpisem a odmítnout čas starší než 5 minut. Stiskněte Ověřit podpis a příklady pro hotový kód.

Testovat, pozastavit a obnovit

• Odeslat test odesílá testovací událost a ukazuje HTTP kód a čas, který to trvalo.
• Pozastavit zastaví dodávky; Aktivovat je znovu spustí.
• Tajný klíč vytvoří nový klíč. Starý přestane okamžitě fungovat.
• Smazat odstraňuje koncový bod. Jeho záznam je uchován.

Opakované pokusy a protokol

Vaše adresa musí odpovědět kódem 2xx do 5 sekund. Přesměrování nejsou sledována. Pokud to selže, IDup to zkusí znovu po 1 minutě, 5 minutách, 30 minutách, 2 hodinách a 12 hodinách. Po šestém pokusu je doručení označeno Vzdal se.

Log ukazuje každý pokus s událostí, koncovým bodem, pokusem, HTTP kódem, délkou trvání a začátkem odpovědi. Stav je Čekání, Doručeno, Neúspěšné nebo Vzdal se. Použijte Znovu odeslat znovu odeslat dodávku.