eIDAS e-pirkuma API Certyneo Developers

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" }'

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

Webhooks reaģēt reālā laikā

Seši notikumi (envelope.sent, viewed, signed, completed, declined, expired) ar HMAC parakstu, kas ir pārbaudāms un automātiski mēģināts.

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" }
  ]
}

HMAC SHA-256 parakstījums katram payloadam pārbaudīt autentiskumu serverī.

Automātiska atkārtota pārbaude, ja nav panākta: 5 mēģinājumi 24 stundu laikā ar eksponenciālu bākofu.

No vadības pulkstenī var meklēt notikumu žurnālu: skatīt katru mēģinājumu, atgrieztos HTTP statusu, korpusu.

Webhook URL, ko var konfigurēt projektā pa apvalku vai globāli.

Kāpēc API, kas ir veltīta e-saistībām?

Lai integrētu e-pirmu savā produktā, ir svarīgi nodrošināt juridisko atbilstību (eIDAS), tehnisko uzticamību (vebhooks, kas tiešām nāk), un datu suverenitāti (Eiropas viesnīca, lai izvairītos no Cloud Act).

Tas ir izstrādāts un izstrādāts programmatoriem, un seko mūsdienu REST konvencijām: kursorbasētu paginēšanu, idempotences atslēgas, versiju URL, OpenAPI 3.1, lai automātiski radītu klientus.

eIDAS atbilstība paskaidrota programmatoriem

eIDAS regulā ir noteikti trīs parakstu līmeņi: vienkāršs (SES), progresīvs (AES) un kvalificēts (QES). Certyneo API ļauj izvēlēties līmeni pa aploksni ar lapiņu `pirkstu_līmeņu`. Standarta vērtība ir AES (pietiek 95 % B2B gadījumu). QES ir pieejama dokumentiem, kam nepieciešama stingra juridiskā līdzvērtība ar rokraksta parakstu (notariāta dokumenti, publiskie līgumi).

Tehniski AES prasa spēcīgu paraksta autentiskumu (OTP ar SMS, KYC video ar izvēli) un laika zīmogu. QES pievieno kvalifikētu sertifikātu, ko izsniedz kvalificēts ES TSP.

Ieteicamā integrācijas arhitektūra

Visbiežāk sastopamais integrācijas patterns ir šāds:

Jūsu backends izsauca POST /v1/envelopes, lai izveidotu aploksni, un saņem sign_url, ko parādīt lietotājam.
Jūs pārnākat lietotāju uz sign_url vai ievietojat to iframe (ar savu brendi Pro plānā).
Kad parakstīšana ir pabeigta, Certyneo izsauca jūsu webhook ar notikumu envelope.completed.
Jūs atjaunināt savu datubāzi un paziņot lietotājam (e-pasts, aplikācija utt.).

Bezmaksas bezmaksas smilšu kastes

Sandbox vide ir bezmaksas un bez ierobežojumiem. Visas ražošanas funkcijas ir pieejamas, izņemot, ka parakstu ir nelikumīgi (PDF ir atzīmēts kā SANDBOX). Praktiski automātiskajiem testiem, klienta demo, vietējā attīstība. Sandbox atslēgas ir atšķirīgas no prod atslēgas, pilna izolācija starp diviem.

Migrēt no DocuSign vai Yousign

Ja jau esat integrējis DocuSign vai Yousign, API mapping ir vienkāršs: aploksnes → aploksnes, saņēmēji → saņēmēji, status webhooks → status webhooks.

API

Kāds ir API robeža?

Ja jūs esat pārkāpis kvotu, API atgriež 429 ar Retry-After.

Cik maksā API?

Kopumā, AES signālam ir jābūt vismaz 0,40 eiro, un tam nav minimālās abonementas.

Vai ir ALS?

99.95% darbības laiks uz Biznesa un Uzņēmuma plāniem (maksimālais darbības laiks 4 stundas gadā).

Kāda autentiskuma metode jums ir nepieciešama?

Tas ir ļoti vienkāršs, jo tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, jo tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, jo tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, jo tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs, un tas ir ļoti vienkāršs.

Kā pārbaudīt HMAC signālu?

Katrs vebuoks satur X-Certyneo-Signature virsrakstu ar HMAC SHA-256 no payload, kas parakstīts ar jūsu noslēpumaino vebuoku.

Vai SDK ir atvērts avots?

Jā. Node, Python un Ruby SDK ir GitHub licences ietvaros. Jūs varat tos forkēt, sniegt ieguldījumu vai vienkārši audīt. Binārus publicē npm, PyPI un RubyGems ar nosaukuma telpu @certyneo / certyneo.

Vai es varu pārbaudīt bez reģistrācijas?

Jā, izmantojot interaktīvus piemērus API dokumentācijā: /developers/playground. Pieteikumi tiek nosūtīti uz kopīgu smalkšolu, kas nav nepieciešama ar atslēgu. Sadarbībai ar sevi, izveidojiet bezmaksas (neierīkota) programmatora kontu.

E-saistīšanas API programmatoriem

REST + OpenAPI 3.1

Pārliecinātās tīmekļa vietnes

eIDAS atbilstība

Latentība < 200 ms

Sāksot darbam pēc 5 minūtēm.