API semnătură electronică

Fiecare cerere trimite cheia ta API în header-ul Authorization. Nu există flux OAuth și niciun token de reîmprospătat. URL-ul de bază este https://app.esemneaza.ro/api/v1.

1. Încarcă documentul

Încarci un fișier PDF, DOC sau DOCX de cel mult 15 MB. Răspunsul îți dă un fileName pentru apelul următor.

curl --request POST \
  --url https://app.esemneaza.ro/api/v1/files \
  --header 'Authorization: CHEIA_TA_API' \
  --header 'Accept: application/json' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@contract.pdf

# Răspuns
{ "fileName": "a1b2c3d4-...-contract.pdf" }

2. Creează cererea de semnare

Numești semnatarii și le plasezi câmpurile. eSemneaza.ro trimite fiecărui semnatar un link securizat pe email. Răspunsul conține același link, pe care îl poți trimite și prin SMS, în signUrl.

curl --request POST \
  --url https://app.esemneaza.ro/api/v1/requests \
  --header 'Authorization: CHEIA_TA_API' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
    "fileName": "a1b2c3d4-...-contract.pdf",
    "recipients": [
      {
        "type": "EMAIL",
        "email": "ion@exemplu.ro",
        "name": "Ion Popescu",
        "fields": [
          { "type": "SIGNATURE", "pageNum": 1,
            "x": 100, "y": 600, "width": 180, "height": 60, "required": true }
        ]
      }
    ],
    "senderName": "Firma Mea SRL",
    "emailSubject": "Te rugăm să semnezi contractul"
  }'

# Răspuns (prescurtat)
{ "id": "req_...", "status": "IN_PROGRESS",
  "recipients": [ { "id": "rcp_...", "signUrl": "https://app.esemneaza.ro/sign/..." } ] }

3. Descarcă PDF-ul semnat și certificatul

Semnăturile se aplică asincron, așa că aștepți webhook-ul REQUEST_COMPLETED și abia apoi ceri linkurile de descărcare. Ambele apeluri răspund cu 403 până când cererea este finalizată.

# PDF-ul semnat (link valabil aproximativ 2 ore)
curl --request GET \
  --url https://app.esemneaza.ro/api/v1/requests/{requestId}/completed_download_url \
  --header 'Authorization: CHEIA_TA_API' \
  --header 'Accept: application/json'

# Certificatul de semnare (link valabil aproximativ 15 minute)
curl --request GET \
  --url https://app.esemneaza.ro/api/v1/requests/{requestId}/download_certificate_url \
  --header 'Authorization: CHEIA_TA_API' \
  --header 'Accept: application/json'

# Fiecare apel returnează un link de descărcare cu valabilitate scurtă
{ "requestId": "...", "docUrl": "https://..." }
{ "requestId": "...", "certificateUrl": "https://..." }

Încarci signUrl-ul unui semnatar într-un iframe, în propria ta interfață. Semnatarul nu vede nicio redirecționare și niciun tab nou, iar PDF-ul semnat este același: același sigiliu PAdES și același certificat AATL.

<iframe
  src="https://app.esemneaza.ro/sign/..."
  width="100%" height="900" style="border:0"
  allow="camera; clipboard-write">
</iframe>

În referința interactivă a API-ului găsești o consolă „Try it” pentru fiecare endpoint, cu exemple de cod.

Testarea este gratuită. Cu un cont de dezvoltator creezi cereri de semnare nelimitate, iar documentele finalizate au watermark.

Producția rulează pe Planul Pro: 50 RON pe utilizator pe lună sau 480 RON pe utilizator pe an, la plata anuală. Plătești 1 RON pentru fiecare cerere de semnare, indiferent câte persoane o semnează. Primele 50 de cereri de semnare sunt gratuite. Prețurile nu includ TVA.

Tabelul nu ia în calcul cele 50 de cereri gratuite, iar totalul este calculat cu Planul Pro plătit lunar. Toate planurile sunt în secțiunea de prețuri.

O semnătură realizată prin API are valoare juridică pentru majoritatea documentelor din mediul de afaceri, în temeiul Regulamentului eIDAS (UE) nr. 910/2014 și al Legii nr. 214/2024. Pentru unele acte legea cere formă autentică sau semnătură electronică calificată, așa că verifică regulile care se aplică acelor documente.

Semnatarul poate semna cu semnătură electronică simplă sau cu semnătură electronică avansată, confirmată printr-un cod unic (OTP).

Trei straturi păstrează un PDF semnat verificabil și peste ani:

• PAdES. Semnătura este încorporată în interiorul PDF-ului, iar orice modificare făcută după semnare devine detectabilă.
• Certificat AATL. Certificatul de sigilare este înscris pe Adobe Approved Trust List, așa că Adobe Acrobat și Reader afișează semnătura ca validă, fără software suplimentar.
• Marcaj temporal de încredere. Un marcaj temporal emis de o autoritate de marcare temporală de încredere asigură validitate pe termen lung, astfel încât semnătura poate fi verificată și după ce certificatul de semnare expiră.

Poți verifica singur. Finalizează o cerere de semnare, descarcă PDF-ul și deschide-l în Adobe Acrobat Reader. Panoul de semnături ar trebui să arate o semnătură validă, fără avertismente.

eSemneaza.ro este certificat ISO/IEC 27001:2022 și respectă GDPR.