Téigh go dtí an príomhábhar
Certyneo
API REST eIDAS

An t-API síniú leictreonach do fhorbróirí

Cuir síniú leictreonach eIDAS isteach i do chuid iarratais i gceann cúpla uair an chloig. REST, webhooks iontaofa, SDK Node/Python/Ruby, sandbox saor in aisce gan teorainn.

Cuntas Forbróra a chruthú Doiciméadacht API

Sandbox saor in aisce · 99.95% uptime · Cónaitheoir ríoga AE

REST + OpenAPI 3.1

Deireadhphointí intuartha, JSON glan, cóid chaighdeánach HTTP. Spec OpenAPI 3.1 íoslódálach chun do chliaint féin a ghiniúint.

Seirbhísí gréasáin iontaofa

Athchóirithe uathoibríoch le backoff inléite, sínithe HMAC SHA-256, clár imeachtaí inrochtana.

Comhlíonadh eIDAS dúchasach

Tá sínithe AES, AES-Q agus QES ar fáil trí bhratach API.

Tá an t-athrú seo á dhéanamh ag an am céanna.

API óstaithe i Strasbourg (AE), p95 < 200 ms ó na hEorpa.

Tosaíonn sé i gceann cúig nóiméad

Cruthaigh do chéad chlúdach le hiarratais HTTP amháin.

cURL Cúlchiste a chruthú
curl https://api.certyneo.com/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Contrat de prestation",
    "documents": [{"file_url": "https://your.app/contract.pdf"}],
    "recipients": [{"email": "client@example.com", "name": "Jane Doe"}],
    "webhook_url": "https://your.app/webhooks/sign"
  }'

Ní gá ach iarratas POST a dhéanamh chun clúdach a chruthú, doiciméad a chur leis, sínitheoir agus URL an webhook.

SDK oifigiúil Node.js
import Certyneo from '@certyneo/sdk';

const client = new Certyneo({ apiKey: process.env.CERTYNEO_API_KEY });

const envelope = await client.envelopes.create({
  title: 'Contrat de prestation',
  documents: [{ file_url: 'https://your.app/contract.pdf' }],
  recipients: [{ email: 'client@example.com', name: 'Jane Doe' }],
});

console.log(envelope.sign_url); // ready to share with the signer

Soláthraíonn SDK Node TypeScript an cineálú iomlán, bainistíocht earráide uathoibríoch le aththriail, agus tógálaí clúdach sreabhán.

Webhooks freagairt i bhfíor-am

Seacht imeacht (envelope.sent, viewed, signed, completed, declined, expired) le síniú HMAC in-scrúdaithe agus athchóirithe go huathoibríoch.

envelope.completed
{
  "event": "envelope.completed",
  "envelope_id": "env_3a2f...",
  "signed_at": "2026-05-25T14:32:18Z",
  "evidence_url": "https://api.certyneo.com/v1/envelopes/env_3a2f.../audit-trail.pdf",
  "signers": [
    { "email": "client@example.com", "signed": true, "ip": "82.x.x.x" }
  ]
}
  • Sínithe HMAC SHA-256 de gach luaidhe seiceáil an fhírinne ar thaobh an tseirbhéora.
  • Athchúrsáil uathoibríoch i gcás éagmais: 5 thriail in 24 uair an chloig le backoff inléite.
  • Clár imeachtaí atá inrochtana ón mbord: féach gach iarracht, stádas HTTP a tháinig ar ais, an corp.
  • URL webhook a chumarsáidear de réir an chlúdaigh (override) nó de réir an domhain sa tionscadal.

Cén fáth go bhfuil API tiomnaithe le haghaidh síniú leictreonach?

Ní hé an rud is éasca an síniú leictreonach a chomhtháthú i do tháirge. Teastaíonn ráthaíochtaí maidir le comhlíonadh dlíthiúil (eIDAS), iontaofacht theicniúil (webhooks atá ag teacht i ndáiríre), agus ceannasacht sonraí (óstáil Eorpach chun an tAcht Cloud a sheachaint).

Tá sé deartha ag agus do fhorbróirí, agus leanann sé na coinbhinsiúin nua-aimseartha REST: leathanachú bunaithe ar chúrsair, eochair idempotency, leaganú de réir URL, OpenAPI 3.1 chun do chliaint a ghiniúint go huathoibríoch.

Comhlíonadh eIDAS míniú do fhorbróirí

Leagtar síos trí leibhéal sínithe sa Rialachán eIDAS: simplí (SES), ardleibhéal (AES) agus cáilíochtúil (QES).Ligeann Certyneo API an leibhéal a roghnú de réir clúdach trí réimse `signature_level`. Is é AES an luach réamhshocraithe (suimiúil i 95% de chásanna B2B).Tá an QES ar fáil do na gníomhartha a éilíonn comhionannas dlíthiúil déine le síniú lámha scríofa (gníomhartha nótaireachta, conarthaí poiblí).

Ó thaobh teicniúil de, éilíonn AES fíorú láidir ar an síniútóir (OTP trí SMS de réir réamhshocraithe, KYC físeán de rogha) agus rian iniúchóireachta stánaithe. Cuireann an QES teastas cáilithe a eisíodh ag TSP cáilithe AE leis. Déantar an méid sin go léir a bhainistiú ag an API glaoigh ar an bpointe deiridh, déanaimid an chuid eile.

Ailtireacht chomhtháthaithe molta

Is é an patrún comhtháthú is coitianta an sruth seo:

  • Glaonn do chúlchríoch POST /v1/envelopes chun an chúlchríoch a chruthú agus tugann sé sign_url chun a thaispeáint don úsáideoir.
  • Tarraingíonn tú an t-úsáideoir ar ais chuig an sign_url nó cuireann tú isteach é i iframe (le do bhrandaíocht tríd an bplean Pro).
  • Nuair a bheidh an síniú críochnaithe, glaonn Certyneo do webhook leis an ócáid envelope.completed.
  • Nuashonraíonn tú do bhunachar sonraí agus cuireann tú in iúl don úsáideoir (i ríomhphost, in-app, etc.).

Sandbox saor in aisce gan teorainn

Tá an timpeallacht sandbox saor in aisce agus gan teorainn. Tá gach gné táirgeachta ar fáil ach amháin nach bhfuil aon luach dlíthiúil ag síniúcháin (tá SANDBOX marcáilte ar PDF).

Imirce ó DocuSign nó Yousign

Má tá comhtháthú DocuSign nó Yousign agat cheana féin, tá an aip mapála díreach: clúdach → clúdach, faighteoirí → faighteoirí, webhooks staidrimh → webhooks staidrimh.

Ceisteanna API

Cad é an teorainn meáchain an API?

Tá an t-athbhreithniú seo bunaithe ar an méid a bhfuil an t-ábhar a bhfuil an t-ábhar á iarraidh ar an ngrúpa a bhfuil an t-ábhar á iarraidh ar an ngrúpa a bhfuil an t-ábhar á iarraidh air.

Cé mhéad a chosnaíonn an API?

Tá an sandbox saor in aisce agus gan teorainn. Oibríonn an táirgeadh ar íocaíocht ar shíntiús (ó € 0.40 an síntiús AES le laghdú méideanna), gan síntiús íosta. Cuimsíonn an plean Fiontar SLA neartú, whitelisting IP agus cuntas teicniúil tiomnaithe.

An bhfuil ALS ann?

99.95% uptime ar phleananna Gnó agus Fiontar (uasmhéid 4 uair an chloig in aghaidh na bliana).

Cén fhíordheimhniú a úsáideann tú?

Is féidir an t-eolas a fháil ar an gcliaint a bhfuil an t-earraí a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil sé de dhíth orthu a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliaint a bhfuil siad ag iarraidh a chur ar an gcliain a chur ar an gcliain a bhfuil siad ag an gcliain a bhfuil siad ag iarraidh a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt ar an gcliain a thabhairt do an gcliain a thabhairt do an gcliain a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do an gcinn a thabhairt do do do do an gcinn a thabhairt do do do do do do an gcinn a bheith a bheith a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gcinn a bheith ag an gc gc.

Conas a fhíorú síntiús HMAC ar webhook?

Tá ceann scríbe X-Certyneo-Signature ag gach webhook ina bhfuil HMAC SHA-256 den phíolóid, sínithe le do webhook rúnda. Ar thaobh an tseirbhíseora, athchruthaigh an HMAC agus comparáid a dhéanamh i gcónaí ( comparáid sábháilte ama). Déanann an SDK oifigiúil é seo go huathoibríoch trí webhook.verify(payload, síniú, rúnda).

An bhfuil SDKanna foinse oscailte?

Tá. Tá SDKanna Node, Python agus Ruby ar GitHub faoi cheadúnas MIT. Is féidir leat iad a fhórca, a rannchuidiú nó iad a iniúchadh. Foilsítear an bhearnaí ar npm, PyPI agus RubyGems faoin ainmspás @certyneo / certyneo.

An féidir liom triail a bhaint as gan clárú?

Tá, trí na samplaí idirghníomhacha de chuid doiciméadaíochta API: /developers/playground. Téann iarratais i gcoinne sampla sandbox roinnte ann, gan eochair a bheith ag teastáil. Chun úsáid thromchúiseach a bhaint as, cruthaigh cuntas forbróir saor in aisce (sandbox neamhtheoranta).

Tá tú réidh le síniú leictreonach a ionchorprú?

Sandbox saor in aisce gan teorainn, doiciméadú iomlán, SDK oifigiúil.

Léigh an doiciméadú Labhair le Forbróir Certyneo