API semnătură electronică eIDAS

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 reacționați în timp real

Evenimentele plicului și destinatarului, semnătură HMAC verificabilă și relansare automată.

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

Semnătura HMAC SHA-256 a fiecărei încărcături verifica autenticitatea pe partea serverului.

În caz de eşec, reîncercare automată: 5 încercări în 24 de ore cu backoff exponenţial.

Jurnal de evenimente consultabil din panoul de bord: vezi fiecare încercare, statutul HTTP returnat, corpul.

URL-ul webhook configurabil prin înveliș (override) sau global în proiect.

De ce un API dedicat semnăturii electronice?

Integrarea semnăturii electronice în produsul dvs. nu este o chestiune uşoară. Aveți nevoie de garanţii privind conformitatea legală (eIDAS), fiabilitatea tehnică (webhook-uri care vin cu adevărat) şi suveranitatea datelor (hosting european pentru a evita Actul Cloud).

Proiectat de și pentru dezvoltatori, urmărește convențiile moderne REST: paginare bazată pe cursor, chei de idempotency, versiune pe URL, OpenAPI 3.1 pentru a genera clienții dvs. automat. Fără SOAP, fără XML, fără surprize.

Conformitatea eIDAS explicată dezvoltatorilor

Regulamentul eIDAS definește trei niveluri de semnătură: simplu (SES), avansat (AES) și calificat (QES). API Certyneo permite alegerea nivelului pe plic printr-un câmp `semnătură_level`. Valoarea implicită este AES (suficientă pentru 95% din cazurile B2B). QES este disponibilă pentru actele care necesită o echivalență legală strictă cu semnătura manuscrisă manuală (acte notariate, contracte publice).

Pe plan tehnic, AES necesită o autentificare puternică a semnatarului (OTP prin SMS prin implicit, KYC video opțional) și o pistă de audit cu timbră. QES adaugă un certificat calificat emis de un TSP calificat UE. Toate acestea sunt gestionate de API sună la punctul de sfârșit, noi ne ocupăm de restul.

Arhitectura de integrare recomandată

Cel mai comun model de integrare urmează acest flux:

Backend-ul tău cheamă POST /v1/envelopes pentru a crea plicul și primește un sign_url pentru a fi prezentat utilizatorului.
Redirecționați utilizatorul către sign_url sau încorporați-l în iframe (cu branding-ul dvs. prin planul Pro).
După ce semnătura este completată, Certyneo va chema webhook-ul cu evenimentul envelope.completed.
Vă actualizați baza de date și anunțați utilizatorul (e-mail, in-app, etc.).

Sandbox gratuit nelimitat

Sandbox este un mediu gratuit și nelimitat. Toate funcțiile de producție sunt disponibile, cu excepția semnăturii care nu au valoare legală (PDF este marcat SANDBOX).

Și dacă nu doriți să scrieți cod

Tot ceea ce face acest API se controlează și fără a scrie o singură linie, de la un flux: creați un plic, trimiteți-l, reacționați la o semnătură, obțineți PDF-ul sigilat și pista de audit. Aceeași bază, cu un designer vizual în loc de client HTTP. Vedeți integrarea Power Automate și Microsoft 365.

Migrează de la DocuSign sau Yousign

Dacă deja aveți o integrare DocuSign sau Yousign, API-ul de mapping este direct: plicuri → plicuri, recipiente → recipiente, status webhooks → status webhooks. Ghidul nostru de migrare documentează echivalențele de punct de sfârșit pe punct. Așteptați 1-3 zile pentru o migrare completă, mult mai puțin dacă utilizați un wrapper intern.

Vă migrați din Adobe Acrobat Sign (fostul EchoSign, apoi Adobe Sign)? Maparea este la fel de directă — agreements → envelopes, participants → recipients, webhooks → webhooks. Comparați Certyneo și Adobe Acrobat Sign →

Prețul unei API de semnătură electronică: unde cumpărați un abonament?

Nu este nevoie de ofertă sau bon de comandă pentru a cumpăra un abonament API de semnătură: sandbox-ul este gratuit și nelimitat, cheia API se generează din dashboard, iar accesul la API REST de producție este inclus de la planul Standard la 19 €/lună — webhooks și SDK incluse, fără taxe per semnătură.

Standard — 19 €/lună: 100 plicuri/lună, API REST + webhooks, 10 utilizatori
Business — 39 €/lună: 300 plicuri/lună, trimitere în grup, formulare web
Business Pro — 99 €/lună: 1 000 plicuri/lună, API înaltă frecvență (300 req/min), utilizatori nelimitați

Semnătura calificată (QES) este un produs distinct, facturat la acțiune: 9,90 € per semnătură, disponibil pe toate planurile, inclusiv Gratuit.

Pentru volume importante sau o nevoie de angajament contractual (SLA, DPA dedicat, facturare anuală), planul Enterprise se subscrie de la echipa comercială. În orice caz, prețurile sunt publice — comparați-le înainte de a vă angaja.

Fere la întrebări API

Care este limita de rată a API-ului?

În cazul în care se depășește această limită, API-ul returnează 429 cu un Retry-After.

Cât costă API-ul?

Sandbox-ul (chei sk_test_) este gratuit și nelimitat. Accesul la API REST de producție este inclus de la planul Standard la 19 €/lună (100 plicuri/lună), apoi Business la 39 €/lună și Business Pro la 99 €/lună cu cote în creștere; semnătura calificată (QES) este un produs distinct, facturat per act 9,90 € per semnătură. Pentru volume mai mari sau un SLA consolidat, planul Enterprise se contractează direct cu echipa comercială.

Există ALS?

99.95% de timp de funcționare pe planurile Business și Enterprise (maximum 4 ore de downtime pe an). Pagina de statut public cu istoric de incidente: status.certyneo.com. Planul Enterprise include un credit automat în cazul nerespectării SLA.

Ce autentificare folosiţi?

Pentru integrările OAuth (platforma multi-stakeholder), oferim o OAuth 2.0 Client Credentials pe planul Enterprise.

Cum verifici semnătura HMAC a unui webhook?

Fiecare webhook include un X-Certyneo-Signature care conține un HMAC SHA-256 al payload-ului, semnat cu webhook-ul secret. Pe partea serverului, recalculați HMAC-ul și comparați în timp constant (timing-safe comparare). SDK-ul oficial face acest lucru automat prin webhook.verify(payload, semnătură, secret).

SDK-urile sunt open source?

Da. SDK-urile Node, Python și Ruby sunt pe GitHub sub licența MIT. Puteți să le forcați, contribuiți sau pur și simplu să le auditați.

Pot să testez fără să mă înscriu ?

Da, prin exemplele interactive din documentația API: /developers/playground. Cererile se îndreaptă spre o instanță sandbox partajată, fără cheie necesară. Pentru utilizare serioasă, creați un cont de dezvoltator gratuit (sandbox nelimitat).

Cât costă API EchoSign (devenit Adobe Acrobat Sign)?

EchoSign a fost achiziționat de Adobe în 2011, redenumit Adobe Sign apoi Adobe Acrobat Sign: API există încă, dar prețul nu este public și trece printr-o ofertă pentru întreprinderi de la echipa comercială Adobe, de obicei pe tranșe de tranzacții anuale. Dimpotrivă, Certyneo și-a publicat prețurile: accesul API de producție este inclus de la planul Standard la 19 €/lună, contractat online fără ofertă, cu un sandbox gratuit nelimitat pentru a evalua API înainte de plată.

API-ul de semnătură electronică pentru dezvoltatori

REST + OpenAPI 3.1

Site-uri web de încredere

Conformitatea eIDAS nativă

Deținerea de date

Începem în 5 minute.