Luchd-dìon Iframe no Làimhseachadh a-staigh

Embed/iframe an duilleag soidhnidh anns an aplacaid agad fhèin.

Ùrachadh - deasachadh agus soidhnigeadh pàirt JS ri thighinn a dh’aithghearr. Cuir fios thugainn.

Ceanglaichean dìreach

Ma tha feum agad air duilleag furasta fosgailte nach eil feum air gnàthachadh sam bith, far an urrainn do dhuine sam bith a dhol ann agus sgrìobhainn a shoidhnigeadh (agus gu roghnach a’ dearbhadh am post-d aca às dèidh sin), feuch Legalesign Link. Faodaidh tu an dèanamh anns an aplacaid lìn gun chòd. Tha iad comasach cuideachd airson a chur a-steach. Dh'fhaodadh ceanglaichean a bhith airson clàradh tachartais, duilleagan ama, foillseachaidhean cunnairt. Ionnsaich barrachd mu Legalesign Link (duilleagan soidhnidh a ghabhas cur a-steach).

API

Ma tha feum agad air an sgrìobhainn atharrachadh no tuilleadh gnìomhan a dhìth, cleachd an API.

Cuingeachaidhean

Innealan

Tha seo a’ buntainn ri sgrìobhainnean stèidhichte air PDF (chan e sgrìobhainnean stèidhichte air teacsa/html).

• obrachadh math ann am co-theacsan deasg
• obrachadh airson sgrìobhainnean sìmplidh ann am co-theacsan gluasadach (m.e. ainm-sgrìobhte, chan e foirmean iom-fhillte)
• dh’fhaodadh co-theacsan gluasadach far a bheil foirm iom-fhillte agad nach obraich gu math (gu h-àraidh airson iPhones) agus tha sinn a' moladh gun tèid an neach-cleachdaidh a ghluasad gu uinneag brobhsair ùr (faodaidh tu seo a falach le bhith a’ toirt air falbh cus-pàirt bhon duilleag soidhnidh agus ath-thaobhadh, faic gu h-ìosal).

Ged nach eil an roghainn mu dheireadh seo na eòlas gun bhacadh, bheir e eòlas earbsach do na cleachdaichean agad. Faisg air a’ chomas, chan eil e comasach dearbhadh meud an inneil luchd-cleachdaidh taobh a-staigh uinneag iframe (ann an cuid no a h-uile iPhone), a tha ga dhèanamh duilich gluasad glan a dhèanamh timcheall air foirm iom-fhillte.

Inbhe ainm-sgrìobhaidh

Rabhadh eile, gun uiread de phlanaidh is dòcha nach coileanar ris an ìre 'leasachaidh' airson ainm-sgrìobhan dealanach.

Prìomh phrionnsapalan an inbhe:

• feumaidh do neach-soidhnidh a bhith fo smachd sònraichte anns a' phròiseas soidhnidh agus
• feumaidh iad a bhith air an comharrachadh gu sònraichte.

Le bhith a' faighinn a' cheangal soidhnidh fhèin faodaidh tu an sgrìobhainn a shoidhnigeadh; caillidh smachd sònraichte.

Is dòcha gum bi fuasgladh ann le bhith a’ cur dearbhadh SMS ris airson an neach-fhaighinn agad. Bidh faighinn an sin teacsa sms fo smachd sònraichte an neach-fhaighinn agad agus comharraichidh e iad gu sònraichte.

Feumaidh tu plana a dhèanamh air na smachdan a thèid a chur an sàs airson dèanamh cinnteach gu bheil an t-ainm-sgrìobhaidh comharraichte agus fo smachd sònraichte air do thaobh gus an ìre 'leasachaidh' fhaighinn air ais. Ionnsaich barrachd mu lagh air ainm-sgrìobhan dealanach.

Mar a chruthaicheas tu ceangal soidhnidh a ghabhas cur a-steach

Bidh tu air a dhol tron stiùireadh tòiseachaidh sgiobalta agus air sgrìobhainn a chruthachadh/ag iarraidh airson soidhnigeadh gu soirbheachail.

1. Cuir dìreach am feart a leanas ris a' cheist POST a chruthaicheas/aghaidh sgrìobhainn (m.e. /api/v1/document/):

{return_signer_links: true}

2. Leugh Bidh a' fhreagairt agus gheibh thu nì JSON a tha a’ toirt a-steach na ceanglaichean soidhnidh airson gach neach-fhaighinn sgrìobhainn agad.

3. Cuir a-steach am ceangal soidhnidh ann an eileamaid iframe.

Feartan feumail eile

• Gus a h-uile post-d Legalesign a chòmhdach, ann am POST gu /api/v1/document/ sònraich am feart seo: {do_email: false}.

• Gus an neach-cleachdaidh a thionndadh sa bhad às dèidh soidhnigeadh cuir ris an fhear seo: {redirect: yourUrl } (faic barrachd gu h-ìosal).

• Gus cus-pàirt bhon duilleag soidhnidh a thoirt air falbh, cuir an ceist ri ceangal soidhnidh: &hidenav=1&hidetext=1

Thoir sùil air na h-uile feartan ann an òrdugh cuir-sgrìobhainn an seo: Send Document API call

Factar Safari

Ma tha dùil agad ri luchd-cleachdaidh Safari feumaidh tu 'càradh' a chur ris le pìos beag de javascript.

Chan eil ceadan tèarainteachd bunaiteach Safari a’ leigeil le cookies iframe obrachadh. Ma tha thu airson seo a dhìochuimhneachadh gun bhacadh airson neach-cleachdaidh, feumaidh tu a) ar cur thugainn do dhrùchaid freumh, agus b) gum fear de sheòrsa javascript a chleachdas tu mus luchdaich an iframe - cliog an seo airson an còd (gàirdeachas air an jquery, bu chòir dhut a bhith comasach air atharrachadh mar a tha feum). Anns a’ chlàr js feumaidh tu cuid de pharaimearan a chur ris an URL a tha air a sgrùdadh. Ma tha seo doilleir dhan chòd, cuir fios thugainn airson cuideachadh.

Tha Safari air an cleachdadh iframe a dhèanamh nas duilghe.

Ma tha thu airson dèanamh cinnteach gu bheil iframe ag obair ann an Safari, feumaidh tu ar feart ùr CNAME a chleachdadh. Glèidheadh seo duilleagan soidhnidh ann am fo-dhrùchaid do phrìomh dhruidhteachais. Tha am feart seo fhathast ann am beta, cuir fios thugainn ma tha thu airson a chleachdadh.

Is e am fuasgladh as fheàrr luchd-cleachdaidh a chur a-mach gu uinneag brobhsair ùr, às dèidh dhut URL ath-thaobhaidh-às dèidh-soidhnidh a chomharrachadh anns an sgrìobhainn airson an toirt air ais às dèidh crìoch.

Soidhnichean às dèidh crìoch

Tha dà dhòigh ann airson smachd fhaighinn às dèidh soidhnigeadh.

• Suidhich URL ath-thaobhaidh air an sgrìobhainn agad nuair a chruthaicheas tu e. Bidh Legalesign a' stiùireadh an neach-cleachdaidh gu do URL às dèidh crìoch a chur air an sgrìobhainn, no
• cleachd feart postMessage ann am javascript.

url ath-thaobhaidh

Cuir dìreach do URL ath-thaobhaidh ris an fhiosrachadh 'redirect' den iarrtas POST a chruthaicheas an sgrìobhainn (/api/v1/document/).

Leis gu bheil an ath-thaobhadh per-sgrìobhainn (chan e per-neach), cuiridh Legalesign sreang cheistean ris an URL ath-thaobhaidh agad a dh’fhaodadh tu a chleachdadh airson fiosrachadh fhaighinn mu stàite sgrìobhainn agus neach-soidhnidh:

[d’ URL]?signer=[signer UID]&doc=[doc UID]&group=[group UID]&signer_state=[signer status]&doc_state=[doc state]

Cliog air na ceanglaichean seo airson faicinn an clàr iomraidh airson stàite sgrìobhainn agus stàite neach-soidhnidh.

postMessage

Is e postMessage teachdaireachd a tha air a chuir tron javascript a ghabhas faighinn ann am frèam pàrant agad. Faodaidh tu an uairsin na teachdaireachdan sin a chleachdadh airson ath-thaobhadh no ath-chlàradh an duilleig mar a dh'fheumar.

Às dèidh soidhnigeadh gheibh thu sa bhad aon de thrì teachdaireachdan javascript postMessage:

'waiting', 'signed', 'rejected'.

Ma tha an sgrìobhainn air a shoidhnigeadh agus ceadaicheas tu don phròiseas soidhnidh leantainn agus an duilleag luchdaidh a leigeil a-mach anns an iframe agad, gheibh thu cuideachd an teachdaireachd 'download' ma thèid am putan luchdaich sìos a bhriogadh.

Gheibh thu teachdaireachd 'waiting' ma tha barrachd air aon neach-soidhnidh agad agus gu bheil feum air daoine eile an sgrìobhainn a shoidhnigeadh.

Airson tuilleadh fiosrachaidh mu postMessage faic: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage.

Ma tha thu an dùil ath-thaobhadh a dhèanamh air an neach-soidhnidh, bi mothachail gum faic e/cò bheir seachad duilleag ùr (no duilleag 'a’ feitheamh ri feadhainn eile') mus tèid do ath-thaobhadh a chur an gnìomh le postMessage.

Next.

Às dèidh soidhnigeadh faodaidh tu an sgrìobhainn PDF mu dheireadh a luchdachadh sìos. Tha sinn a’ moladh gu mòr gun cleachd thu webhooks airson sin. Ionnsaich barrachd mu webhooks. Thoir sùil air an sgrìobhainn airson an ghairm API airson luchdachadh sìos PDF deireannach. Seachain an luchdachadh sìos sa bhad às dèidh tachartas soidhnidh (a’ cleachdadh nan soidhnichean às dèidh-soidhnidh gu h-ìosal), is dòcha nach bi am PDF deireannach deiseil. Nas earbsach, èist ris a’ webhook far a bheil an nì ‘document’ agus an tachartas ‘finalPdfCreated’.