Sleamhnú go príomh-ábhar

Iframe nó Sínithe Ionsáite

Cuir isteach/leithghlasáil an leathanach sínithe i do aip féin.

Nuashonrú - Comhpháirt JS le haghaidh eagarthóireachta agus síniú ar fáil go luath. Déan teagmháil linn.

Má tá leathanach oscailte simplí uait nach éilíonn aon saincheaptha, áit ar féidir le haon duine dul agus doiciméad a shíniú (agus, más mian leo, a r-phost a dhearbhú ina dhiaidh sin), bain triail as Legalesign Link. Is féidir leat iad seo a dhéanamh san aip gréasáin gan cód. Tá siad in-ionsáite freisin. D’fhéadfadh samplaí de naisc a bheith cláraithe imeachta, bileoga ama, díghlasálaithe freagrachta. Foghlaim níos mó faoin Na nasc Legalesign (leathanaigh sínithe in-ionsáite).

API​

Má tá ort an doiciméad a shaincheapadh, nó má theastaíonn níos mó feidhmiúlachta uait, bain úsáid as an API.

Sriananna​

Gléasanna​

Tá sé seo ag baint le doiciméid atá bunaithe ar PDF (ní doiciméid bunaithe ar téacs/html).

  • Oibríonn comhthéacsanna deisce go maith
  • Oibríonn comhthéacsanna soghluaiste do dhoiciméid shimplí (m.sh. síniú amháin, ní foirmeacha casta)
  • D’fhéadfadh go n-oibreodh comhthéacsanna soghluaiste ina bhfuil foirm chasta go dona (go háirithe ar iPhones) agus molaimid duit an t-úsáideoir a chur i bhfuinneog bhrabhsálaí nua láithreach (is féidir leat é seo a chur faoi cheilt trí rudaí gan ghá den leathanach sínithe a bhaint agus athrú reatha, féach thíos).

Cé nach UX shílseach é an rogha dheireanach, cinnteoidh sé taithí iontaofa do do úsáideoirí. Dar linn féin, níl sé indéanta a bheith cinnte faoin méid ar ghléas an úsáideora ó laistigh d’fhuinneog iframe (i roinnt iPhones nó go léir), rud a fhágann nach bhfuil nascleanúint ghlan timpeall ar fhoirm chasta iontaofa.

Caighdeán sínithe​

Rabhadh eile, gan pleanáil áirithe d’fhéadfá nach sroicheann tú caighdeán sínithe leictreonach “ardfhorbartha”.

Áirítear ar phrionsabail an chaighdeáin

  • caithfidh do shíntóir a bheith i smacht iomlán ar an bpróiseas sínithe agus
  • caithfidh siad a bheith indílis go uathúil.

Trí fháil ar an nasc sínithe tú féin is féidir leat an doiciméad a shíniú anois; cailltear an smacht iomlán.

D’fhéadfadh réiteach a bheith ann trí bhailíochtú SMS a chur leis do do ghnáthfháílí. Beidh an téacs sms sin faoin smacht iomlán do ghnáthfháílí agus aithneoidh sé iad go uathúil.

Beidh ort pleanáil cé na rialacha atá i bhfeidhm chun a chinntiú go bhfuil an síntóir indílis agus i smacht iomlán ar do thaobh chun an caighdeán “ardfhorbartha” sin a fháil ar ais. Foghlaim níos mó faoin dlí ar shíníochtaí leictreonacha.

Beidh tú tar éis an ceannródaigh tapa a leanúint agus doiciméad a chruthú/seoladh le síniú go rathúil.

  1. Cuir an tréith seo a leanas leis an iarraidh POST a chruthóidh/seolfaidh doiciméad (m.sh. /api/v1/document/):
{return_signer_links: true}

  1. Léigh COMHLACHTA an fhreagra agus gheobhaidh tú réad JSON le naisc sínithe do gach faighteoir do dhoiciméad.

  2. Cuir an nasc sínithe laistigh d’eilimint iframe.

Tréithe cabhracha eile​

  • Chun gach ríomhphost Legalesign a chosc, sa iarratas POST chuig /api/v1/document/ socraigh an tréith seo: {do_email: false}.

  • Chun athrú a dhéanamh ar an úsáideoir láithreach tar éis sínithe cuir leis an tréith seo: {redirect: yourUrl } (féach níos mó thíos).

  • Chun dramhaíl a bhaint den leathanach sínithe, cuir leis an tsringa ceiste seo leis an nasc sínithe: &hidenav=1&hidetext=1

Athbhreithnigh gach tréith sheoladh-doiciméad anseo: Glao API ar Sheoladh Doiciméad

Comhthéacs Safari​

Má tá súil agat le húsáideoirí Safari b’fhéidir go mbeidh ort 'deisiú' beag bídeach a chur leis le píosa beag JavaScript.

Ní cheadaíonn socruithe slándála réamhshocraithe Safari fianáin iframe. Más mian leat é seo a láimhseáil gan cur isteach ar an úsáideoir, beidh ort a) do lárdheighilt a chur chugainn, agus b) roinnt JavaScript a fhorghníomhú sula luchtú an iframe - cliceáil anseo don cód (may còmhréire do jquery, ba chóir duit é a choigeartú de réir mar is gá). Laistigh den js beidh ort roinnt paraiméadair a chur leis an URL a iarrtar. Mura bhfuil sé soiléir ón sampla cód déan teagmháil linn le haghaidh cúnamh.

Tá sé crua anois iframe a úsáid i Safari.

Más mian leat a chinntiú go n-oibríonn iframe i Safari beidh ort ár ngné nua CNAME a úsáid. Cuirfidh sé seo na leathanaigh sínithe i bhfóirdheighilt de do phríomh-dheighilt. Tá an ghné seo fós i mbéite, déan teagmháil linn má tá suim agat í a úsáid.

Is é an rogha is fearr ná úsáideoirí a chur i bhfuinneog bhrabhsálaí nua, tar éis duit URL athraithe tar éis sínithe a shocrú ar an doiciméad chun iad a thabhairt ar ais tar éis don chomhlánú tarlú (féach thíos).

Comharthaí tar éis comhlánaithe​

Tá dhá bhealach ann chun smacht a ghlacadh tar éis sínithe.

  • Socraigh URL athraithe ar do dhoiciméad nuair a chruthaíonn tú é. Athróidh Legalesign an t-úsáideoir chuig do URL tar éis doiciméad a chomhlánú, nó
  • bain úsáid as gné postMessage JavaScript.

URL athraithe​

Cuir do URL athraithe leis an tréith 'redirect' san iarratas POST a chruthaíonn an doiciméad (/api/v1/document/).

Ós rud é go bhfuil an athrú de réir doiciméid (ní de réir duine), cuirfidh Legalesign sríng cheiste leis an URL athraithe agat ar féidir leat a úsáid chun eolas a bhailiú faoi staid an doiciméid agus an síntóra:

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

Cliceáil ar na naisc seo chun tábla tagartha a fheiceáil do stádas doiciméid agus stádas síntóra.

postMessage​

Is teachtaireacht postMessage teachtaireacht a sheoltar trí JavaScript agus is féidir leat é a fháil i do fhráma tuismitheora. Ansin is féidir leat na teachtaireachtaí sin a úsáid chun atúsáid URL nó athluchtaigh an leathanach de réir mar is gá.

Tar éis sínithe gheobhaidh tú láithreach ceann de thrí teachtaireacht javascript postMessage féideartha: 'waiting', 'signed', 'rejected'.

Má tá an doiciméad sínithe agus lig tú don phróiseas sínithe leanúint agus lig tú don leathanach íoslódála a luchtú i do iframe, gheobhaidh tú freisin an teachtaireacht 'download' má chliceálann tú ar an gcnaipe íoslódála doiciméid.

Gheobhaidh tú teachtaireacht 'waiting' má tá níos mó ná 1 síntóir agat agus go bhfuil ort fós daoine eile ón doiciméad a shíniú.

Le haghaidh tuilleadh eolais faoi postMessage féach: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage.

Má tá sé i gceist agat an síntóir a atreorú, tabhair faoi deara go bhféadfadh sé/sí leathanach nua a fheiceáil go gairid (nó leathanach 'download' nó 'ag fanacht ar dhaoine eile') sula nglacann an athrú do postMessage éifeacht.

Ar Aghaidh.​

Tar éis sínithe is féidir leat an doiciméad PDF deiridh a íoslódáil. Molaimid duit webhooks a úsáid chun é sin a dhéanamh. Foghlaim níos mó faoi webhooks. Féach ar an ndoiciméadú don ghlao API chun PDF deiridh a íoslódáil. Seachain iarraidh an íoslódáil díreach tar éis imeacht sínithe (ag úsáid na gcomharthaí tar éis sínithe thuas), b’fhéidir nach mbeidh an PDF deiridh réidh fós. Níos iontaofa, éist le webhook nuair atá an t-ábhar 'document' agus an t-imeacht 'finalPdfCreated'.

Athbhreithnithe go deireanach ar

Export This Article

Save a copy of this page as PDF or plain text.