Teagmhais doiciméid a sheoladh le crúcaí gréasáin (webhooks)
Seolann crúca gréasáin JSON sínithe chuig do URL nuair atá doiciméad seolta, oscailte, sínithe, críochnaithe, diúltaithe, as feidhm nó cealaithe. Teastaíonn Pro; socraíonn úinéirí agus riarthóirí é.
Tá an t-aistriúchán seo níos sine ná an t-alt Béarla, mar sin d'fhéadfadh roinnt sonraí a bheith athraithe. Léigh an leagan Béarla
Ar an leathanach seo
Seolann crúca gréasáin teachtaireacht chuig URL de do chuid gach uair a tharlaíonn rud éigin do dhoiciméad, ionas gur féidir le do chóras féin gníomhú air. Is cuid de Pro iad crúcaí gréasáin: oibríonn siad i spás oibre fad a bhíonn Pro ag duine dá úinéirí, agus ní féidir ach le húinéirí agus le riarthóirí iad a bhainistiú. Tá a chuid féin ag gach spás oibre.
Crúca gréasáin a chur leis
- Oscail Socruithe agus brandáil i roghchlár an chuntais agus téigh go Comhtháthuithe.
- Brúigh Cuir crúca gréasáin leis.
- Cuir isteach URL an chríochphointe. Caithfidh sé tosú le
https://agus a bheith poiblí: diúltaítear do sheoltaí i líonraí príobháideacha, do sheoltaí Sealsimple féin agus do URLanna le hainm úsáideora agus pasfhocal. - Cuir Ainm leis más mian leat, roghnaigh na Teagmhais (tá tic le gach ceann ar dtús) agus brúigh Cuir crúca gréasáin leis.
- Cóipeáil an Rún sínithe a thaispeántar, agus brúigh Seol teagmhas tástála.
Is féidir suas le 10 gcrúca gréasáin a bheith ag spás oibre.
Teagmhais
document.sent: Doiciméad seoltadocument.viewed: Oscailte ag faighteoir, uair amháin in aghaidh an fhaighteoradocument.signed: Sínithe ag sínitheoir, uair amháin in aghaidh an tsínitheoradocument.completed: Críochnaithe: shínigh gach duinedocument.declined: Diúltaithedocument.expired: As feidhmdocument.canceled: Cealaithe
An méid a sheolaimid
POST le corp JSON: id (mar an gcéanna ar gach iarracht, ionas gur féidir leat teachtaireachtaí dúblacha a scipeáil), event, created_at, workspace_id, document le id, title, status agus url, agus i gcás teagmhas faoi dhuine amháin, recipient le name, email agus role. Tá an stádas voided ag doiciméad cealaithe. Ní sheoltar an PDF sínithe féin. Tá an teagmhas test ag an teagmhas tástála, le doiciméad agus sínitheoir samplacha.
Seiceáil an síniú
Tá ceanntásc Sealsimple-Signature ar nós t=1700000000,v1=… ar gach iarratas, in aice le Sealsimple-Event agus Sealsimple-Delivery. Chun é a sheiceáil:
- Tóg corp amh an iarratais, go díreach mar a tháinig sé.
- Léigh
t(am Unix i soicindí) agusv1ón gceanntásc. - Ríomh HMAC-SHA256 de
t, ponc agus an corp, le do rún sínithe iomlán mar eochair, i bhformáid heicsidheachúlach le litreacha beaga. - Ná glac leis an iarratas ach amháin má tá sé seo cothrom le
v1(déan comparáid in am tairiseach) agus nach bhfuiltníos sine ná cúpla nóiméad.
Faoi Conas ceangal, taispeánann Seiceáil an síniú (Node.js) é seo mar chód, le Cóipeáil an cód. Cuireann Rún nua rún nua in ionad an rúin láithreach, mar sin nuashonraigh do sheiceáil díreach ina dhiaidh.
Iarrachtaí arís, an loga agus cur ar sos
Freagair le stádas 2xx laistigh de 10 soicind. Murach sin, déanaimid iarracht arís níos déanaí, suas le 6 iarracht san iomlán thar thart ar lá. Ní leanaimid atreoruithe, agus stopann freagra 410 na hiarrachtaí. Taispeánann an Loga seachadta na 50 teachtaireacht is déanaí le freagra do chríochphointe, agus seolann Seol arís ceann acu arís.
Tar éis 20 seachadadh as a chéile a theip, cuirimid an crúca gréasáin ar sos (Ar sos de bharr teipeanna) agus seolaimid ríomhphost chuig úinéirí an spáis oibre. Deisigh an críochphointe, cas an crúca gréasáin air arís agus seol arís ón loga an méid a theastaíonn uait. Is féidir leat crúca gréasáin a chur ar sos lena lasc freisin: ní sheoltar níos déanaí teagmhais a tharlaíonn fad is atá sé ar sos. Gan Pro, fanann crúcaí gréasáin ach ní sheolann siad aon rud.