Webhooks: l-avvenimenti tad-dokumenti fis-sistema tiegħek
Webhook jibgħat messaġġ JSON iffirmat lill-URL tiegħek meta dokument ikun mibgħut, miftuħ, iffirmat, komplut, irrifjutat, skadut jew ikkanċellat. Jeħtieġ il-Pro; jissettjawh sidien u amministraturi.
Din it-traduzzjoni hija eqdem mill-artiklu bl-Ingliż, għalhekk xi dettalji setgħu nbidlu. Aqra l-verżjoni bl-Ingliż
F'din il-paġna
Webhook jibgħat messaġġ lil URL tiegħek kull darba li jiġri xi ħaġa lil dokument, biex is-sistema tiegħek tkun tista' taġixxi fuqu. Il-webhooks huma parti mill-Pro: jaħdmu fi spazju tax-xogħol sakemm wieħed mis-sidien tiegħu jkollu l-Pro, u s-sidien u l-amministraturi biss jistgħu jimmaniġġjawhom. Kull spazju tax-xogħol għandu tiegħu.
Żid webhook
- Iftaħ Issettjar u identità fil-menu tal-kont u mur għal Integrazzjonijiet.
- Agħfas Żid webhook.
- Daħħal l-URL tal-endpoint. Irid jibda b'
https://u jkun pubbliku: indirizzi f'netwerks privati, l-indirizzi ta' Sealsimple stess u URLs b'isem tal-utent u password jiġu rrifjutati. - Jekk trid, żid Isem, agħżel l-Avvenimenti (għall-bidu kollha mmarkati) u agħfas Żid webhook.
- Ikkopja ċ-Ċavetta sigrieta tal-firma li tidher, u agħfas Ibgħat avveniment tat-test.
Spazju tax-xogħol jista' jkollu sa 10 webhooks.
Avvenimenti
document.sent: Dokument mibgħutdocument.viewed: Miftuħ minn riċevitur, darba għal kull riċeviturdocument.signed: Iffirmat minn firmatarju, darba għal kull firmatarjudocument.completed: Komplut: kulħadd iffirmadocument.declined: Irrifjutatdocument.expired: Skadutdocument.canceled: Ikkanċellat
X'nibagħtu
POST b'body JSON: id (l-istess f'kull tentattiv, biex tkun tista' taqbeż id-duplikati), event, created_at, workspace_id, document b'id, title, status u url, u, għall-avvenimenti dwar persuna waħda, recipient b'name, email u role. Dokument ikkanċellat għandu l-istatus voided. Il-PDF iffirmat innifsu ma jintbagħatx. L-avveniment tat-test għandu l-avveniment test u dokument u firmatarju fittizji.
Iċċekkja l-firma
Kull talba għandha header Sealsimple-Signature bħal t=1700000000,v1=…, flimkien ma' Sealsimple-Event u Sealsimple-Delivery. Biex tiċċekkjaha:
- Ħu l-body mhux ipproċessat tat-talba, eżatt kif wasal.
- Aqra
t(ħin Unix f'sekondi) uv1mill-header. - Ikkalkula l-HMAC-SHA256 ta'
t, punt u l-body, biċ-ċavetta sigrieta tal-firma tiegħek, sħiħa, bħala ċ-ċavetta, f'hex b'ittri żgħar. - Aċċetta t-talba biss jekk dan ikun daqs
v1(qabbel f'ħin kostanti) utma jkunx eqdem minn ftit minuti.
Taħt Kif tqabbad, Iċċekkja l-firma (Node.js) juri dan bħala kodiċi, b'Ikkopja l-kodiċi. Ċavetta ġdida tibdel iċ-ċavetta sigrieta minnufih, għalhekk aġġorna l-verifika tiegħek eżatt wara.
Tentattivi mill-ġdid, ir-reġistru u s-sospensjoni
Wieġeb bi status 2xx fi żmien 10 sekondi. Inkella nerġgħu nippruvaw aktar tard, sa 6 tentattivi b'kollox fuq madwar ġurnata. Ir-ridirezzjonijiet ma jiġux segwiti, u tweġiba 410 twaqqaf it-tentattivi. Ir-Reġistru tal-kunsinni juri l-aħħar 50 messaġġ bit-tweġiba tal-endpoint tiegħek, u Erġa' ibgħat jerġa' jibgħat wieħed.
Wara 20 kunsinna li fallew wara xulxin, nissospendu l-webhook (Sospiż wara żbalji) u nibagħtu email lis-sidien tal-ispazju tax-xogħol. Sewwi l-endpoint, erġa' ixgħel il-webhook u erġa' ibgħat dak li għandek bżonn mir-reġistru. Tista' wkoll tissospendi webhook bis-swiċċ tiegħu: l-avvenimenti li jiġru waqt li jkun sospiż ma jintbagħtux aktar tard. Mingħajr il-Pro, il-webhooks jibqgħu iżda ma jibagħtu xejn.