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ż

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

  1. Iftaħ Issettjar u identità fil-menu tal-kont u mur għal Integrazzjonijiet.
  2. Agħfas Żid webhook.
  3. 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.
  4. Jekk trid, żid Isem, agħżel l-Avvenimenti (għall-bidu kollha mmarkati) u agħfas Żid webhook.
  5. 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ħut
  • document.viewed: Miftuħ minn riċevitur, darba għal kull riċevitur
  • document.signed: Iffirmat minn firmatarju, darba għal kull firmatarju
  • document.completed: Komplut: kulħadd iffirma
  • document.declined: Irrifjutat
  • document.expired: Skadut
  • document.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:

  1. Ħu l-body mhux ipproċessat tat-talba, eżatt kif wasal.
  2. Aqra t (ħin Unix f'sekondi) u v1 mill-header.
  3. 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.
  4. Aċċetta t-talba biss jekk dan ikun daqs v1 (qabbel f'ħin kostanti) u t ma 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.

Dan l-artiklu kien utli?

Ipprovah bil-ftehim li jmiss tiegħek.

5 dokumenti b'xejn kull xahar kalendarju. Mingħajr karta ta' kreditu.

Għadek teħtieġ l-għajnuna?

Staqsi lill-assistent tagħna fiċ-chat: iwieġeb minnufih. Jew ibgħatilna email, u persuna twieġbek fi żmien jum tax-xogħol wieħed.