Ce este un API de semnătură electronică
Un API de semnătură electronică este interfața prin care aplicația ta (CRM, ERP, platformă internă, aplicație de HR sau logistică) trimite documente direct către un serviciu de semnare, fără ca utilizatorul să părăsească mediul tău software. În loc ca un angajat să descarce un PDF, să îl trimită manual pe email și să aștepte răspuns, fluxul devine o operațiune programatică: un apel API trimite documentul, un altul urmărește statusul, iar documentul semnat revine automat în sistemul tău.
Pentru companii cu volume mari de documente — contracte, comenzi, polițe, acorduri de muncă — diferența dintre un flux manual și unul automatizat prin API se măsoară în ore de muncă recuperate lunar, nu doar în confort.
API-ul eSemneaza.ro este documentat integral la esemneaza.stoplight.io. Este disponibil pentru conturile cu plan Pro activ.
Cum funcționează: arhitectura în doi pași
Spre deosebire de soluțiile complexe care cer configurări extinse, API-ul eSemneaza.ro este structurat în jurul a două operațiuni esențiale.
Pasul 1 — Upload document
Documentul (.doc, .docx sau .pdf) este transmis prin API printr-un apel POST către endpoint-ul de upload. Răspunsul conține un identificator unic al fișierului, necesar la pasul următor.
POST /upload
Authorization: Bearer {TOKEN}
Content-Type: multipart/form-data
→ Răspuns: { "filename": "f-7a23b1..." }Pasul 2 — Creare cerere de semnare
Cu identificatorul obținut, se creează cererea de semnare, specificând semnatarii, ordinea de semnare (secvențial sau simultan) și tipul de autentificare suplimentară (OTP prin SMS sau email).
POST /request
Authorization: Bearer {TOKEN}
Content-Type: application/json
{
"filename": "f-7a23b1...",
"title": "Contract servicii — Client X",
"signers": [
{ "email": "client@exemplu.ro", "phone": "+40700000000", "order": 1 }
]
}Din momentul acestui apel, semnatarul primește un link securizat (pe email sau SMS) și poate semna direct de pe orice dispozitiv, fără cont și fără să instaleze nimic.
Documentația completă a celor două endpoint-uri, inclusiv toate câmpurile opționale disponibile, este descrisă în detaliu pe esemneaza.stoplight.io.
„Bring your own UI”: semnare embedded, fără să părăsești aplicația
Una dintre cerințele frecvente ale echipelor tehnice este posibilitatea de a păstra experiența de semnare în interiorul propriei aplicații, fără să redirecționeze utilizatorul către un domeniu extern.
API-ul eSemneaza.ro suportă acest model prin integrare de tip embedded/iframe: procesul de semnare este afișat direct în aplicația ta. Utilizatorul nu observă nicio tranziție către o platformă terță. Pentru produse software B2B sau B2C unde experiența utilizatorului trebuie să rămână unitară de la un capăt la altul, această opțiune elimină un punct de fricțiune frecvent întâlnit la alte platforme de semnătură electronică.
În plus, cererile de semnare pot fi trimise și prin SMS, nu doar prin email. Semnatarul nu este obligat să dețină sau să folosească o adresă de email pentru a semna un document.
Securitate și trasabilitate la nivel de API
Fiecare document trimis prin API beneficiază de aceleași mecanisme de securitate disponibile și în interfața web:
- Jurnal de audit complet, accesibil programatic — cine a accesat documentul, de pe ce adresă IP, la ce oră
- Sigilare digitală PAdES (PDF Advanced Electronic Signatures), care face orice modificare ulterioară a documentului detectabilă instant
- Autentificare OTP opțională (cod unic transmis prin SMS sau email), configurabilă per cerere de semnare
- Stocare în Google Cloud, cu certificare ISO/IEC 27001:2022
Valoarea juridică a tuturor tipurilor de semnătură electronică recunoscute de eIDAS este confirmată explicit de Legea nr. 214/2024, care elimină orice ambiguitate legată de admisibilitatea acestora ca mijloc de probă în instanță.
Cost: ce plătești efectiv pentru integrarea API
Structura de cost pentru integrarea API este simplă și predictibilă:
| Componentă | Cost |
|---|---|
| Abonament Pro (necesar pentru acces API) | 50 RON / lună |
| Cerere de semnare (document trimis spre semnare) | 1 RON / cerere |
Costul per cerere este negociabil pentru volume mai mari, prin contact direct cu echipa eSemneaza.ro. Pentru companii cu un mix de utilizatori — unii lucrând direct din interfața web, alții consumând API-ul programatic — există și pachete hibride personalizate.
Pentru detalii vezi secțiunea de prețuri.
Cum începi: cont de test și acces la documentație
Înainte de a integra API-ul în producție, ai două opțiuni de testare:
- Cont standard cu perioadă de probă de 14 zile, activabil direct din pagina de înregistrare — fără card, fără setup tehnic prealabil.
- Cont gratuit de testare/dezvoltare API, util mai ales pentru echipele care vor să testeze fluxul complet (upload → cerere → semnare → webhook)
Documentația tehnică integrală — endpoint-uri, scheme de request/response, coduri de eroare — este disponibilă la esemneaza.stoplight.io.
Pentru cine are sens integrarea API (și pentru cine nu)
Integrarea API are sens clar atunci când:
- volumul lunar de documente trimise spre semnare depășește pragul la care procesarea manuală, document cu document, devine costisitoare în timp de echipă;
- documentele sunt generate automat din alt sistem (CRM, ERP, platformă de facturare) și ar fi redundant să fie descărcate și reîncărcate manual;
- aplicația ta are propriii utilizatori finali, iar experiența de semnare trebuie să rămână integrată, nu redirecționată către o platformă externă.
Dacă volumul este redus sau echipa preferă control vizual direct asupra fiecărui document trimis, interfața web eSemneaza.ro acoperă același nivel de securitate și valoare juridică, fără nicio linie de cod.
Concluzie
API-ul eSemneaza.ro reduce integrarea semnăturii electronice la două apeluri HTTP: unul pentru upload, unul pentru trimiterea cererii de semnare. Restul — securitate, trasabilitate, conformitate legală — este gestionat de platformă. Pentru echipele tehnice care evaluează o soluție de semnătură electronică integrabilă, documentația completă este disponibilă public la esemneaza.stoplight.io, iar un cont de test poate fi activat în câteva minute.
