Sealsimple
Alusta tasuta

Dokumendisündmuste saatmine oma süsteemi webhookidega

Webhook (Pro) saadab teie URL-ile allkirjastatud JSON-i, kui dokument saadetakse, avatakse, allkirjastatakse, valmib, lükatakse tagasi, aegub või tühistatakse. Seadistab omanik või administraator.

See tõlge on ingliskeelsest artiklist vanem, seega võivad mõned üksikasjad olla muutunud. Loe ingliskeelset versiooni

Webhook saadab teie URL-ile sõnumi iga kord, kui dokumendiga midagi juhtub, et teie süsteem saaks sellele reageerida. Webhookid kuuluvad Pro-paketti: need töötavad tööruumis, kui ühel selle omanikest on Pro-pakett, ja neid saavad hallata ainult omanikud ja administraatorid. Igal tööruumil on oma webhookid.

Webhooki lisamine

  1. Avage kontomenüüs Seaded ja kujundus ja minge jaotisse Integratsioonid.
  2. Vajutage Lisa webhook.
  3. Sisestage Lõpp-punkti URL. See peab algama eesliitega https:// ja olema avalik: privaatvõrkude aadressid, Sealsimple'i enda aadressid ning kasutajanime ja parooliga URL-id lükatakse tagasi.
  4. Soovi korral lisage Nimi, valige Sündmused (alguses on kõik märgitud) ja vajutage Lisa webhook.
  5. Kopeerige ilmuv Allkirjavõti ja vajutage Saada testsündmus.

Tööruumis võib olla kuni 10 webhooki.

Sündmused

  • document.sent: Dokument saadetud
  • document.viewed: Saaja avas, üks kord saaja kohta
  • document.signed: Allkirjastaja allkirjastas, üks kord allkirjastaja kohta
  • document.completed: Valmis: kõik on allkirjastanud
  • document.declined: Tagasi lükatud
  • document.expired: Aegunud
  • document.canceled: Tühistatud

Mida me saadame

POST-päring JSON-sisuga: id (iga katse puhul sama, et saaksite duplikaadid vahele jätta), event, created_at, workspace_id, document koos väljadega id, title, status ja url ning ühte inimest puudutavate sündmuste puhul recipient koos väljadega name, email ja role. Tühistatud dokumendi olek on voided. Allkirjastatud PDF-i ennast ei saadeta. Testsündmuse sündmus on test ning dokument ja allkirjastaja on väljamõeldud.

Allkirja kontrollimine

Igal päringul on päis Sealsimple-Signature kujul t=1700000000,v1=…, lisaks päised Sealsimple-Event ja Sealsimple-Delivery. Kontrollimiseks:

  1. Võtke päringu töötlemata sisu täpselt sellisena, nagu see saabus.
  2. Lugege päisest t (Unixi aeg sekundites) ja v1.
  3. Arvutage t, punkti ja sisu HMAC-SHA256, kasutades võtmena kogu oma allkirjavõtit, väiketähtedega kuueteistkümnendkujul (hex).
  4. Aktsepteerige päring ainult siis, kui tulemus on võrdne väärtusega v1 (võrrelge konstantse ajaga) ja t on kõige rohkem mõne minuti vanune.

Jaotises Kuidas ühendada näitab Allkirja kontrollimine (Node.js) seda koodina koos nupuga Kopeeri kood. Uus võti asendab võtme kohe, seega uuendage oma kontrolli kohe pärast seda.

Korduskatsed, logi ja peatamine

Vastake 10 sekundi jooksul 2xx-olekukoodiga. Muidu proovime hiljem uuesti, kokku kuni 6 katset umbes ööpäeva jooksul. Ümbersuunamisi ei järgita ja vastus 410 lõpetab katsed. Edastuslogi näitab viimased 50 sõnumit koos teie lõpp-punkti vastusega ja Saada uuesti saadab sõnumi uuesti.

Pärast 20 järjestikust ebaõnnestunud edastust peatame webhooki (Peatatud tõrgete tõttu) ja saadame tööruumi omanikele e-kirja. Parandage lõpp-punkt, lülitage webhook uuesti sisse ja saatke logist uuesti, mida vajate. Webhooki saate peatada ka selle lülitiga: peatamise ajal toimunud sündmusi hiljem ei saadeta. Ilma Pro-paketita jäävad webhookid alles, kuid ei saada midagi.

Kas sellest artiklist oli abi?

Proovige oma järgmise lepinguga.

Saatke tasuta 5 dokumenti igas kalendrikuus. Krediitkaarti pole vaja.

Vajate veel abi?

Küsige meie assistendilt vestluses: ta vastab kohe. Või kirjutage meile e-kiri ja inimene vastab ühe tööpäeva jooksul.