API elektronického podpisu eIDAS — 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

Webhook reagujte v reálném čase

Události obálky a příjemce, ověřitelný podpis HMAC a automatické připomenutí.

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 podpis každé nákladu ověřte autenticitu na serverové straně.

Automatické retry v případě selhání: 5 pokusů za 24 hodin s exponenciálním back-offem.

Záznam událostí prohlížitelný z přístrojového panelu: každý pokus, vrácený status HTTP, tělo.

URL webhooku, který lze konfigurovat jako přehled nebo globální v projektu.

Proč by měl být API určený pro elektronické podpisy?

Vytvoření elektronického podpisu do vašeho produktu není snadné. Potřebujete záruky na právní shodu (eIDAS), technickou spolehlivost (webhooky, které skutečně přicházejí) a svrchovanost dat (evropský hosting, aby se zabránilo zákonu Cloud).

Je navržen pro vývojáře a dodržuje moderní konvence REST: stránkování založené na kurzorech, klíče idempotence, verze podle URL, OpenAPI 3.1 pro automatické generování klientů.

eIDAS splnění vysvětleno pro vývojáře

V souladu s pravidly eIDAS jsou definovány tři úrovně podpisu: jednoduché (SES), pokročilé (AES) a kvalifikované (QES). Certyneo API umožňuje vybrat úroveň podle obálky prostřednictvím pole `signature_level`. Předvolenou hodnotou je AES (dostatečná pro 95% případů B2B).

Technicky AES vyžaduje silnou autentizaci signatáře (default OTP SMS, KYC video opce) a časově značenou auditní stopu. QES přidává kvalifikované certifikáty vydané kvalifikovanými TSP EU. To vše je spravováno API voláte na koncový bod, my se postaráme o zbytek.

Doporučená integrační architektura

Nejběžnější integrační vzor sleduje tento tok:

Váš backend volá POST /v1/envelopy, aby vytvořil obálku a dostane sign_url, který bude prezentován uživateli.
Můžete přesměrovat uživatele na sign_url nebo ho vložit do iframu (s vaším značkem přes Pro plán).
Po dokončení podpisu Certyneo zavolá váš webhook s událostí envelope.completed.
Aktualizujete databázi a informujete uživatele (e-mail, aplikace atd.).

Sandbox zdarma, bez omezení.

Sandbox je bezplatné a neomezené prostředí. Všechny výrobní funkce jsou k dispozici, kromě toho, že podpisy nemají právní hodnotu (PDF je označen jako SANDBOX). Praktické pro automatizované testování, klientské demonstrace, lokální vývoj. Sandbox klíče jsou odděleny od klíčů prod, naprostá izolace mezi nimi.

A co když nechcete psát kód

Vše, co toto rozhraní API dělá, lze ovládat také bez psaní jednoho řádku z toku: vytvořit obálku, ji poslat, reagovat na podpis, získat zapečetěné PDF a jeho audit trail. Stejný základ, ale s vizuálním návrhářem místo HTTP klienta. Viz integrace Power Automate a Microsoft 365.

Přesun z DocuSign nebo Yousign

Pokud už máte integraci DocuSign nebo Yousign, mapování API je jednoduché: obálky → obálky, příjemci → příjemci, status webhooks → status webhooks.

Migrujete z Adobe Acrobat Sign (dříve EchoSign, poté Adobe Sign)? Mapování je stejně přímé — agreements → envelopes, participants → recipients, webhooks → webhooks. Porovnání Certyneo a Adobe Acrobat Sign →

Cena API pro elektronický podpis: kde koupit předplatné?

Pro nákup předplatného API pro podpis není třeba nabídky ani objednávky: sandbox je zdarma a neomezeně, klíč API se generuje z panelu správy, a přístup k REST API produkce je včetně od plánu Standard 19 €/měs. — s webhooks a SDK bez nákladů za podpis.

Standard — 19 €/měs: 100 obálky/měs., API REST + webhooks, 10 uživatelů
Podnikání — 39 €/měsíc: 300 obálky/měsíc, skupinový odesílání, webové formuláře
Podnikání Pro — 99 €/měsíc: 1 000 obálky/měsíc, vysokofrekvenční API (300 požadavků/min), neomezený počet uživatelů

Kvalifikovaný podpis (QES) je samostatný produkt, fakturován za každou akci: 9,90 € za podpis, k dispozici na všech plánech, včetně Volného.

Pro velké objemy nebo potřebu smluvního závazku (SLA, dedikovaná DPA, roční fakturace) se plán Enterprise sjednává s obchodním týmem. V každém případě jsou ceny veřejné — porovnejte je před závazkem.

API

Jaký je limit API?

V případě překročení kvóty se API vrátí 429 s Retry-After.

Kolik stojí API?

Sandbox (klíče sk_test_) je zdarma a neomezené. Přístup k REST API vývojovému prostředí je zahrnut v plánu Standard za 19 €/měsíc (100 obálky/měsíc), následující plány Business za 39 €/měsíc a Business Pro za 99 €/měsíc s rostoucími kvóty; kvalifikovaná podpisová služba (QES) je oddělený produkt, fakturovaný za jednotku 9,90 € za podpis. Pro větší objemy nebo zvýšené SLA se přihlásit k plánovi Enterprise musíte kontaktovat komerční tým.

Je tu ALS?

99,95% uptime na Business a Enterprise plánech (max. 4 hodiny výpadku ročně).

Jaké ověření používáte?

Pro integrace OAuth (multi-stakeholder platform) nabízíme OAuth 2.0 Client Credentials na podnikové úrovni.

Jak ověřit HMAC podpis webhooku?

Každý webhook obsahuje X-Certyneo-Signature hlavičku obsahující HMAC SHA-256 z nákladu, podepsanou s vaším tajným webhookem. Na serverové straně přepočítejte HMAC a porovnejte v konstantním čase (timing-safe comparison). Oficiální SDK to dělá automaticky přes webhook.verify(payload, signature, secret).

Jsou SDK open source?

Ano. SDK Node, Python a Ruby jsou na GitHub pod licencí MIT. Můžete je forkovat, přispívat nebo jen auditovat.

Můžu to otestovat bez registrace?

Ano, pomocí interaktivních příkladů v dokumentaci API: /developers/playground. Dotazování se tam obrací proti sdílené sandboxové instance bez nutnosti klíče. Pro vážné použití si vytvořte bezplatný účet vývojáře (neomezený sandbox).

Jaká je cena API EchoSign (nyní Adobe Acrobat Sign)?

EchoSign byl v roce 2011 koupě Adobe, změněn na Adobe Sign a následně na Adobe Acrobat Sign: API existuje stále, ale jeho cena není veřejná a vyžaduje se podání podnikové nabídky přes komerční tým Adobe, obvykle v trvalejch zákaznických blokách. Naopak Certyneo prohlásil své ceny: přístup k produktnímu API je zahrnut v plánu Standard za 19 €/měsíc, online bez podání nabídky, s neomezeným sandboxem zdarma pro hodnocení API před platbou.

E-Signature API pro vývojáře

REST + OpenAPI 3.1

Spolehlivé webhooky

Národní eIDAS

Požadavky na provozní provozní náklady

Start za 5 minut.