API REST eIDAS

E-Signature API pre vývojárov

Vstaňte elektronický podpis eIDAS do aplikácie za pár hodín. REST, spoľahlivé webhooky, Node/Python/Ruby SDK, neobmedzená voľná sandbox.

Vytvorenie konta vývojára Dokumentácia API

Bezplatná sandbox · 99,95% uptime · Sovereign hosting EÚ

REST + OpenAPI 3.1

Predvídateľné koncové body, čisté JSON, štandardné kódy HTTP. Špecifikácia OpenAPI 3.1 na stiahnutie na generovanie vašich vlastných klientov.

Spoľahlivé webhooku

Automatický pokus s exponenciálnym oneskorením, podpis HMAC SHA-256, konzultovateľný záznam udalostí. Bez poollingu na kódovanie.

Natívna zhoda s eIDAS

Podpisy AES, AES-Q a QES dostupné prostredníctvom príznaku API. Kvalifikovaná stopa auditu zahrnutá, kvalifikované certifikáty TSP EÚ.

Latenčnosť < 200 ms

API hostované v Štrasburgu (EÚ), p95 < 200 ms z Európy. SLA 99,95 % dostupnosti, verejný stav v reálnom čase.

Spustenie za 5 minút

Vytvorte vašu prvú obálku s jedinou požiadavkou HTTP.

cURL — Vytvorenie obálky

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

Jedna požiadavka POST stačí na vytvorenie obálky, pridanie dokumentu, signatára a URL webhooku. API vracia sign_url pripravený na zdieľanie.

Oficiálny SDK 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

SDK Node TypeScript poskytuje úplné typovanie, automatickú správu chýb s opakovanými pokusmi a plynulý konštruktor obálky. Dostupný aj v jazykoch Python a Ruby.

Webhooku — reagujte v reálnom čase

Udalosti obálky a príjemcu, overiteľný podpis HMAC a automatické pripomenutie.

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

Podpis HMAC SHA-256 každej užitočnosti — overte pravosť na strane servera.
Automatický pokus v prípade zlyhania: 5 pokusov za 24 hodín s exponenciálnym oneskorením.
Konzultovateľný záznam udalostí z dashboardu: vidzte každý pokus, vrátený stav HTTP, telo.
URL webhooku konfigurovateľná podľa obálky (prepísanie) alebo globálna v projekte.

Prečo vyhradené API pre elektronický podpis?

Integrácia elektronického podpisu do vášho produktu nie je triviálna. Potrebujete záruky na právnu zhodu (eIDAS), technickú spoľahlivosť (webhouku, ktoré naozaj prídu) a zvrchovanosť údajov (európsky hosting, aby ste sa vyhnuli Cloud Act). API Certyneo pokrýva všetky tri.

Navrhnuté vývojármi a pre vývojárov, dodržiava moderné konvencie REST: stránkovanie založené na kurzore, kľúče idempotentnosti, verzovanie pomocou URL, OpenAPI 3.1 na automatické generovanie vašich klientov. Bez SOAP, bez XML, bez prekvapení.

Zhoda s eIDAS vysvetlená pre vývojárov

Nariadenie eIDAS definuje tri úrovne podpisu: jednoduchý (SES), pokročilý (AES) a kvalifikovaný (QES). API Certyneo umožňuje zvoliť si úroveň na obálku prostredníctvom poľa `signature_level`. Predvolená hodnota je AES (postačujúca pre 95 % prípadov B2B). QES je dostupná pre akty vyžadujúce prísnu právnu ekvivalenciu s manuálnym písomným podpisom (notárske akty, verejné obstarávania).

Na technickej strane AES vyžaduje silné overenie signatára (OTP prostredníctvom SMS štandardne, video KYC ako voliteľnú) a časovanú stopu auditu. QES pridáva kvalifikovaný certifikát vystavený kvalifikovaným TSP EÚ. To všetko spravuje API — zavoláte koncový bod, my sa postaráme o zvyšok.

Odporúčaná architektúra integrácie

Najčastejší vzor integrácie nasleduje tento tok:

Váš backend zavolá POST /v1/envelopes na vytvorenie obálky a dostane sign_url, ktorý predstaví používateľovi.
Presmerujete používateľa na sign_url alebo ho vložíte do iframu (s vaším brandingom cez plán Pro).
Po dokončení podpisu Certyneo zavolá váš webhook s udalosťou envelope.completed.
Aktualizujete svoju databázu a upozorníte používateľa (e-mail, in-app atď.).

Bezplatné neobmedzené pieskovisko

Prostredie pieskoviska je bezplatné a neobmedzené. Všetky produkčné funkcie sú dostupné, okrem toho, že podpisy nemajú právnu hodnotu (PDF je označený SANDBOX). Praktické pre automatizované testy, ukážky klientov, lokálny vývoj. Kľúče pieskoviska sa líšia od produkčných kľúčov, úplná izolácia medzi nimi.

A ak nechcete písať kód

Všetko, čo táto API robí, sa dá ovládať aj bez napísania riadka kódu, z toku: vytvorenie obálky, jej odoslanie, reakcia na podpis, získanie utesnených PDF a jeho audítnej stopy. Rovnaký základ, s vizuálnym návrhom namiesto HTTP klienta. Pozrite integráciu Power Automate a Microsoft 365.

Migrácia z DocuSign alebo Yousign

Ak už máte integráciu DocuSign alebo Yousign, mapovanie API je priame: obálky → obálky, príjemcovia → príjemcovia, webhouku statúsu → webhouku statúsu. Náš návod migrácie zdokumentuje ekvivalencie koncový bod za koncovým bodom. Počítajte s 1 až 3 dňami na kompletnú migráciu, oveľa menej, ak používate interný wrapper.

Migrácia z Adobe Acrobat Sign (predtým EchoSign, potom Adobe Sign) ? Mapovanie je rovnako priame — agreements → envelopes, participants → recipients, webhooks → webhooks. Porovnanie Certyneo a Adobe Acrobat Sign →

Cena API elektronického podpisu: kde kúpiť predplatné?

Nie je potrebný žiadny odhad ani objednávka na kúpu API abonentného podpisu: sandbox je bezplatný a neobmedzený, kľúč API sa generuje z panelu, a prístup k API REST v produkcii je zahrnutý už od plánu Standard za 19 €/mesiac — webhooky a SDK v cene, bez poplatkov za podpis.

Standard — 19 €/mesiac: 100 obálok/mesiac, API REST + webhooky, 10 používateľov
Business — 39 €/mesiac: 300 obálok/mesiac, hromadné odoslanie, webové formuláre
Business Pro — 99 €/mesiac: 1 000 obálok/mesiac, API s vysokou frekvenciou (300 požiadaviek/min), neobmedzení používatelia

Kvalifikovaný podpis (QES) je samostatný produkt fakturovaný za akt: 9,90 € za podpis, dostupný vo všetkých tarifách, vrátane bezplatného.

Pre veľké objemy alebo potrebu zmluvného záväzku (SLA, vyhradený DPA, ročné fakturácie), plán Enterprise sa uzatvára s obchodným tímom. V každom prípade sú ceny verejné — porovnajte ich skôr, ako sa zaviažete.

Často kladené otázky — API

Aký je limit rýchlosti API?

1 000 požiadaviek za minútu štandardne, zvýšiteľné na požiadavku pre vysoké použitie (továrne, multi-tenant platformy). Hlavička X-RateLimit-Remaining v každej odpovedi indikuje zvyšnú kvótu. V prípade prekročenia API vracia 429 s Retry-After.

Koľko stojí API?

Sandbox (klúče sk_test_) je bezplatný a neobmedzený. Prístup k API REST v produkcii je zahrnutý už od plánu Standard za 19 €/mesiac (100 obálok/mesiac), potom Business za 39 €/mesiac a Business Pro za 99 €/mesiac s rastúcimi kvótami; kvalifikovaný podpis (QES) je odlišný produkt, fakturovaný za akt 9,90 € za podpis. Pre väčšie objemy alebo posilnené SLA sa plán Enterprise uzatvára u obchodného tímu.

Existuje SLA?

99,95 % dostupnosti pri plánoch Business a Enterprise (maximálny výpadok 4 hodiny ročne). Verejná stránka stavu s históriou incidentov: status.certyneo.com. Plán Enterprise zahŕňa automatický úver v prípade nedodržania SLA.

Akú autentifikáciu používate?

Bearer token (kľúč API) v hlavičke Authorization. Kľúče sú rotovateľné z dashboardu s okamžitým odvolaním. Pre integrácie OAuth (multi-tenant platforma) ponúkame OAuth 2.0 Client Credentials v pláne Enterprise.

Ako overiť podpis HMAC webhooku?

Každý webhook obsahuje hlavičku X-Certyneo-Signature obsahujúcu HMAC SHA-256 užitočnosti, podpísanú vašou tajnou hodnotou webhooku. Na strane servera prepočítajte HMAC a porovnajte v konštantnom čase (porovnanie bezpečné voči času). Oficiálny SDK to automaticky robí prostredníctvom webhook.verify(payload, signature, secret).

Sú SDK open source?

Áno. SDK Node, Python a Ruby sú na GitHube pod licenciou MIT. Môžete ich fork, prispieť alebo jednoducho auditovať. Binárne súbory sú publikované na npm, PyPI a RubyGems pod menným priestorom @certyneo / certyneo.

Môžem testovať bez registrácie?

Áno, prostredníctvom interaktívnych príkladov v dokumentácii API: /developers/playground. Požiadavky sa tu spúšťajú na zdieľanej sandbox inštancii bez potreby kľúča. Na seriózne použitie si vytvorte bezplatný vývojársky účet (neobmedzený sandbox).

Koľko stojí API EchoSign (teraz Adobe Acrobat Sign)?

EchoSign bol kúpený spoločnosťou Adobe v roku 2011, premenovaný na Adobe Sign a potom Adobe Acrobat Sign: API stále existuje, ale jeho cena nie je verejná a ide cez obchodnú ponuku od obchodného tímu Adobe, zvyčajne podľa ročných transakčných tranší. Naopak, Certyneo zverejňuje svoje ceny: prístup k API v produkcii je zahrnutý už od plánu Standard za 19 €/mesiac, uzatváraný online bez ponuky, s bezplatným neobmedzeným sandboxom na vyhodnotenie API pred platbou.

Ste pripravení integrovať elektronický podpis?

Neobmedzený bezplatný sandbox, kompletná dokumentácia, oficiálne SDK. Začnite teraz.

Čítať dokumentáciu Povedať si s vývojárom Certyneo