Odoslať udalosti do vášho vlastného systému pomocou webhookov

Webhook umožňuje IDup zavolať vašu webovú adresu v momente, keď sa niečo stane, napríklad keď je faktúra zaplatená. Každé doručenie je podpísané a opakuje sa, ak váš systém neodpovie.

Pridať koncový bod

1. Otvorte Webhooks kartu a stlačte Pridať koncový bod.
2. Zadajte Meno a DPH. URL. Musí byť verejne dostupná. Adresy v rámci súkromnej siete sú z bezpečnostných dôvodov odmietnuté.
3. Označte Udalosti čo chcete.
4. Voliteľné: vyberte API kľúč. Koncový bod potom prijíma iba udalosti, ktoré tento kľúč môže čítať.
5. Stlačte Uložiť. IDup zobrazuje Váš podpisový tajný kľúč raz. Uložte ho bezpečne.

Udalosti

• Faktúra vytvorená, Faktúra zaplatená, Platba prijatá
• Nový zákazník, Nový kontakt, Nový lead, Nový tiket
• Ponuka prijatá — ponuka, ktorú zákazník prijal

Každá dodávka obsahuje tri hlavičky: názov udalosti, číslo dodávky a podpis. Opakovaný pokus má rovnaké číslo dodávky, takže váš systém môže rozpoznať duplikáty.

Skontrolovať podpis

Váš systém by mal vypočítať HMAC-SHA256 nad časom a surovým telom s vaším tajomstvom, porovnať ho s podpisom a odmietnuť čas starší ako 5 minút. Stlačte Overiť podpis a príklady pre hotový kód.

Testovať, pozastaviť a obnoviť

• Odošlite test posiela testovaciu udalosť a zobrazuje HTTP kód a čas, ktorý to trvalo.
• Pauza zastaví dodávky; Aktivovať ich znova spustí.
• Tajomstvo rolovania vytvorí nový tajný kľúč. Starý prestane okamžite fungovať.
• Vymazať odstraňuje koncový bod. Jeho záznam sa uchováva.

Opakované pokusy a záznam

Vaša adresa musí odpovedať kódom 2xx do 5 sekúnd. Presmerovania sa nesledujú. Ak zlyhá, IDup sa pokúsi znova po 1 minúte, 5 minútach, 30 minútach, 2 hodinách a 12 hodinách. Po šiestom pokuse je doručenie označené Vzdal sa.

Záznam ukazuje každý pokus s udalosťou, koncovým bodom, pokusom, HTTP kódom, trvaním a začiatkom odpovede. Stav je Čakanie, Doručené, Neúspešné alebo Vzdal sa. Použite Znovu odoslať odoslať dodávku znova.