Lähetä tapahtumat omaan järjestelmääsi webhookien avulla

Webhook antaa IDupin kutsua verkkosivustoasi heti, kun jotain tapahtuu, esimerkiksi kun lasku maksetaan. Jokainen toimitus allekirjoitetaan ja toistetaan, jos järjestelmäsi ei vastaa.

Lisää päätepiste

1. Avaa Webhooks välilehti ja paina Lisää päätepiste.
2. Anna Nimi ja URL. Sen on oltava julkisesti saavutettavissa. Osoitteet yksityisessä verkossa hylätään turvallisuussyistä.
3. Rastita Tapahtumat haluatte.
4. Valinnainen: valitse API-avain. Päätepiste vastaanottaa sitten vain tapahtumia, joita tämä avain voi lukea.
5. Lehdistö Tallenna. IDup näyttää Allekirjoitussalaisuutesi kerran. Säilyttäkää se turvallisesti.

Tapahtumat

• Lasku luotu, Lasku maksettu, Maksu vastaanotettu
• Uusi asiakas, Uusi yhteystieto, Uusi liidi, Uusi tiketti
• Tarjous hyväksytty — tarjous, jonka asiakas hyväksyi

Jokaisessa toimituksessa on kolme otsikkoa: tapahtuman nimi, toimitusnumero ja allekirjoitus. Uudelleenlähetys käyttää samaa toimitusnumeroa, jotta järjestelmäsi tunnistaa kaksoiskappaleet.

Tarkista allekirjoitus

Järjestelmäsi tulisi laskea HMAC-SHA256 ajan ja raakasisällön perusteella salaisuutesi kanssa, verrata sitä allekirjoitukseen ja hylätä yli 5 minuuttia vanha aika. Paina Tarkista allekirjoitus ja esimerkit valmiille koodille.

Testaa, keskeytä ja uusi

• Lähetä testi lähettää testitapahtuman ja näyttää HTTP-koodin ja siihen kuluneen ajan.
• Tauko pysäyttää toimitukset; Aktivoi käynnistää ne uudelleen.
• Salainen avain luo uuden salaisuuden. Vanha lakkaa toimimasta heti.
• Poista poistaa päätepisteen. Sen loki säilytetään.

Uudelleenyritykset ja loki

Osoitteesi on vastattava 2xx-koodilla 5 sekunnin kuluessa. Uudelleenohjauksia ei seurata. Jos se epäonnistuu, IDup yrittää uudelleen 1 minuutin, 5 minuutin, 30 minuutin, 2 tunnin ja 12 tunnin kuluttua. Kuudennen yrityksen jälkeen toimitus merkitään Luovutettu.

Lokissa näkyy jokainen yritys tapahtuman, päätepisteen, yrityksen, HTTP-koodin, keston ja vastauksen alun kanssa. Tila on Odottaa, Toimitettu, Epäonnistui tai Luovutettu. Käytä Lähetä uudelleen lähettääksesi toimituksen uudelleen.