Ugrás a fő tartalomra
Certyneo
REST API — eIDAS

Az elektronikus aláírási API fejlesztőknek

Az elektronikus aláírási API lehetővé teszi, hogy szoftvere aláírásra küldjön egy dokumentumot, kövesse az egyes aláírásokat, és kézi beavatkozás nélkül letöltse az aláírt PDF-et. A Certyneo API-ja REST API HMAC-kel aláírt webhookokkal és iframe-be ágyazott aláírással: ingyenes tesztkulcsok, az éles használat pedig már a Szabványos csomagtól jár, havi nettó 19 € áron.

Inkább egy AI-asszisztensből irányítaná a küldést? Ismerje meg a ChatGPT-hez és Claude-hoz készült összekötőt.

Ingyenes tesztkulcsok · 99,9 %-os SLA (Business és Enterprise) · EU-s tárolás

REST + OpenAPI-specifikáció

Kiszámítható végpontok, tiszta JSON, szabványos HTTP-kódok. Letölthető OpenAPI-specifikáció saját kliensek generálásához.

Megbízható webhooks

5 próbálkozás egyre hosszabb várakozással, HMAC SHA-256 aláírás, a sikertelen események az irányítópultról újraküldhetők. Nem kell pollingot kódolni.

Natív eIDAS megfelelőség

Egyszerű, fokozott (SMS-es OTP) és minősített aláírás, borítékonként választva a signatureLevel mezővel. Minden aláírt dokumentumhoz időbélyeggel ellátott audit trail tartozik.

EU-s tárolás

Szerverek Németországban, Franciaországban és Spanyolországban. Csomagonként közzétett kéréskorlátok és X-RateLimit fejlécek minden válaszban. 99,9 %-os SLA a Business és Enterprise csomagban.

Hogyan küldhető aláírásra egy dokumentum API-n keresztül?

Töltse fel a PDF-et, hozza létre a borítékot, küldje el: három HTTP-kérés elég.

cURL — feltöltés, létrehozás, küldés
# 1. Upload the PDF
curl https://certyneo.com/api/v1/documents \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -F "file=@contrat.pdf"
# → { "id": "cm8doc...", "status": "READY", ... }

# 2. Create the envelope (draft)
curl https://certyneo.com/api/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Contrat de prestation",
    "documentIds": ["cm8doc..."],
    "recipients": [{ "email": "client@example.com", "name": "Jane Doe" }]
  }'
# → { "id": "cm8env...", "status": "DRAFT", ... }

# 3. Send the invitations
curl -X POST https://certyneo.com/api/v1/envelopes/cm8env.../send \
  -H "Authorization: Bearer $CERTYNEO_API_KEY"

A POST /documents visszaadja a PDF azonosítóját, a POST /envelopes piszkozatot hoz létre az aláírókkal, majd a POST /envelopes/:id/send elküldi a meghívókat. Az előrehaladásról ezután webhook értesít.

Node.js — natív fetch, függőségek nélkül
// Node 18+ — native fetch, no dependency
import { readFile } from "node:fs/promises";

const API = "https://certyneo.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.CERTYNEO_API_KEY}` };

// 1. Upload the PDF
const form = new FormData();
const pdf = new Blob([await readFile("contrat.pdf")], { type: "application/pdf" });
form.append("file", pdf, "contrat.pdf");
const doc = await (await fetch(`${API}/documents`, { method: "POST", headers: auth, body: form })).json();

// 2. Create the envelope (draft)
const envelope = await (await fetch(`${API}/envelopes`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify({
    subject: "Contrat de prestation",
    documentIds: [doc.id],
    recipients: [{ email: "client@example.com", name: "Jane Doe" }],
  }),
})).json();

// 3. Send the invitations
await fetch(`${API}/envelopes/${envelope.id}/send`, { method: "POST", headers: auth });

Nincs szükség SDK-ra: az API a Node 18 natív fetch-ével vagy bármely HTTP-klienssel használható. Az OpenAPI-specifikációból típusos kliens is generálható az Ön nyelvén.

Hogyan fogadhatók az aláírási események webhookon keresztül?

A boríték- és címzett-események, ellenőrizhető HMAC-aláírás és automatikus újraküldés.

envelope.completed
{
  "id": "cm8f2h6a10004qr9k5p2wm3xt",
  "event": "envelope.completed",
  "data": {
    "envelopeId": "cm7x2k9p40001qz8h3f7bn2ld",
    "subject": "Contrat de prestation",
    "status": "COMPLETED",
    "completedAt": "2026-09-26T08:42:13.000Z",
    "recipientCount": 1,
    "recipients": [
      { "email": "client@example.com", "name": "Jane Doe", "role": "SIGNER", "status": "SIGNED" }
    ],
    "signedDocumentUrl": "https://storage.certyneo.com/signed/...pdf?X-Amz-Expires=604800&..."
  },
  "timestamp": "2026-09-26T08:42:13.521Z"
}
  • SHA-256 HMAC aláírás minden payload-hoz — ellenőrizze a hitelességet szerver oldalon.
  • Automatikus újrapróbálkozás átmeneti hiba esetén: 5 kísérlet körülbelül 1 h 20 alatt exponenciális visszalépéssel.
  • A sikertelen események az irányítópulton listázva vannak, és egy kattintással újraküldhetők. 5 egymást követő hiba után a végpont felfüggesztésre kerül, és Ön értesítést kap.
  • Legfeljebb 5 végpont a Standard, 15 a Business és 50 a Business Pro csomagban, mindegyik az Ön által választott eseményekre feliratkozva.

Certyneo webhooks dokumentáció

Miért dedikált API az elektronikus aláíráshoz?

Az elektronikus aláírás beépítése a termékébe nem apróság. Garanciákra van szüksége a jogi megfelelőség (eIDAS), a műszaki megbízhatóság (webhookok, amelyek tényleg megérkeznek) és az adatok feletti rendelkezés terén: a Certyneo francia jog szerint működő társaság, és az Ön adatai az Európai Unióban maradnak. A Certyneo API mindhárom területet lefedi.

Fejlesztők tervezték fejlesztőknek, és a REST konvencióit követi: verzió az URL-ben (/api/v1), lapozás page és limit paraméterekkel, JSON-hibák gépileg olvasható kóddal, OpenAPI-specifikáció a kliensek generálásához. Nincs SOAP, nincs XML, nincsenek meglepetések.

Milyen eIDAS aláírási szintet válasszon az API-n keresztül?

Az eIDAS rendelet az aláírás három szintjét határozza meg: egyszerű (SES), fokozott biztonságú (AES) és minősített (QES). A Certyneo API-ban minden boríték szintje a signatureLevel mezővel választható: SIMPLE (alapértelmezett), ADVANCED vagy QUALIFIED. Az egyszerű aláírás a legtöbb szokásos üzleti szerződéshez elegendő; a QES akkor kell, ha jogszabály vagy a címzett a saját kezű aláírással egyenértékűséget követel meg.

Technikailag a fokozott szint automatikusan bekapcsolja az SMS-es OTP-t, és minden aláíró telefonszámát kéri. Az audit trail az RFC 3161 szabvány szerinti időbélyeget kap. A QES egy uniós minősített bizalmi szolgáltató által kiadott minősített tanúsítványon alapul. Minden az API-n keresztül vezérelhető.

Milyen integrációs architektúrát válasszon?

A leggyakoribb integrációs minta ezt az folyamatot követi:

  • Az Ön backendje feltölti a PDF-et (POST /api/v1/documents), piszkozatként létrehozza a borítékot (POST /api/v1/envelopes), majd elküldi (POST /api/v1/envelopes/:id/send).
  • Az aláíró e-mailben kapja meg a meghívót, vagy közvetlenül az Ön felületén ír alá az iframe-be ágyazott aláírásnak köszönhetően (POST /api/v1/envelopes/:id/embed-url, a Standard csomagtól).
  • Az aláírás befejezése után a Certyneo meghívja a webhook-ját az envelope.completed eseménnyel.
  • Frissíti az adatbázisát és értesíti a felhasználót (e-mail, alkalmazáson belüli, stb.).

Hogyan tesztelheti az API-t fizetés nélkül?

Az sk_test_ kulcsok minden csomagban elérhetők, az Ingyenes csomagban is, és a tesztborítékok nem fogyasztják a havi keretet. Az Ingyenes csomagban csak a saját e-mail-címére küldhetők, és óránként 20 kérésre korlátozottak; az éles API-t megnyitó csomagokban óránként 200 és 1000 kérés között. A tesztadatok 30 nap után törlődnek. Egy ingyenes fiók első tesztkulcsa ráadásul egy napra a Szabványos csomagot is megnyitja.

Beépíthető az aláírás kódírás nélkül?

Mindent, amit ez az API csinál, vezérelhet kódírás nélkül is egy folyamatból: boríték létrehozása, elküldése, aláírásra reagálás, a lezárt PDF és az auditnaplója letöltése. Ugyanaz az alap, vizuális tervező helyett HTTP-kliens nélkül. Lásd a Power Automate és Microsoft 365 integrációt.

Hogyan migrálható egy DocuSign- vagy Yousign-integráció?

Ha már van DocuSign- vagy Yousign-integrációja, a szókincs hasonló: envelopes → envelopes, recipients → recipients, státusz-webhookok → webhookok. A DocuSignról és Yousignról a Certyneóra való áttérés útmutatója lépésenként bemutatja a folyamatot, a sablonok exportjától a webhookok átállításáig.

Átköltözik az Adobe Acrobat Sign-ból (korábban EchoSign, majd Adobe Sign)? A leképezés éppen olyan közvetlen — agreements → envelopes, participants → recipients, webhooks → webhooks. A Certyneo és az Adobe Acrobat Sign összehasonlítása →

Az elektronikus aláírási API ára: hol lehet előfizetést vásárolni?

Nincs szükség árajánlatra vagy megrendelőre, hogy aláírási API-előfizetést vásároljon: a tesztkulcsok ingyenesek, az API-kulcsot az irányítópulton generálja, és az éles REST API-hozzáférés már a 19 €/hó árú Standard csomagban benne van — webhookokkal együtt, egyszerű aláírásonkénti díj nélkül.

Az éles API-t megnyitó csomagok (havi nettó árak, hűségidő nélkül)
CsomagHavi nettó árBorítékok havontaKérések percenként és kulcsonkéntWebhook-végpontokHavonta tartalmazott minősített aláírások
Szabványos19 EUR1006050
Üzleti39 EUR300120151
Business Pro99 EUR1000300503

A minősített aláírás (QES) alkalmanként kerül számlázásra, és küldéskor kell kifizetni: előfizetéssel 9,90 € aláírásonként, amelyet az elmentett bankkártyáról vonunk le, miután a Business és Business Pro csomagban foglalt QES-ek elfogytak, előfizetés nélkül pedig 14,90 €.

Nagy mennyiségek vagy szerződéses kötelezettség szükségessége esetén (SLA, dedikált DPA, éves számlázás), az Enterprise-terv a kereskedelmi csapattal kerül megkötésre. Mindenesetre az árak nyilvánosak — hasonlítsa össze őket, mielőtt vállalná magát.

Az egyes csomagok részletei a Certyneo díjszabása oldalon találhatók; hogy ezek az árak hogyan viszonyulnak más szolgáltatókhoz, azt az elektronikus aláírás árainak összehasonlítása mutatja meg.

Tovább a témában

Gyakran feltett kérdések — API

Mi az API-nak a sebességkorlátja?

A korlát kulcsonként, percenként érvényes, csomagtól függően: 60 kérés a Standard, 120 a Business, 300 a Business Pro és 1 000 az Enterprise csomagban. Minden válasz tartalmazza az X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléceket; a korlát felett az API 429-et ad vissza Retry-After fejléccel.

Mennyibe kerül az API?

A tesztkulcsok (sk_test_) minden csomagban ingyenesek. Az éles REST API-hozzáférés a 19 €/hó árú Standard csomagtól érhető el (100 boríték/hó), ezt követi a Business 39 €/hó és a Business Pro 99 €/hó áron, növekvő keretekkel; a minősített aláírás (QES) alkalmanként kerül számlázásra, előfizetéssel 9,90 €. Nagyobb volumenhez az Enterprise csomag az értékesítési csapaton keresztül rendelhető meg.

Van SLA?

Igen: 99,9 %-os havi rendelkezésre állás a Business és Enterprise csomagban, a mért eltéréstől függően 10–50 %-os számlajóváírással. A szolgáltatás állapota folyamatosan közzé van téve a Certyneo állapotoldalán.

Milyen hitelesítést használnak?

API-kulcs az Authorization fejlécben (Bearer sk_live_… vagy sk_test_…). A kulcsok az irányítópulton hozhatók létre és vonhatók vissza, azonnali hatállyal.

Hogyan ellenőrizheto a webhook HMAC aláírása?

Minden webhook X-Certyneo-Signature fejlécet tartalmaz: a kérés nyers törzsének hexadecimális HMAC SHA-256 aláírását, az Ön végpontjának titkos kulcsával számolva. Számolja újra a szerveren a módosítatlan törzsön, és hasonlítsa össze konstans idejű összehasonlítással (Node-ban crypto.timingSafeEqual, Pythonban hmac.compare_digest).

Van hivatalos SDK?

Még nem jelent meg. Az API bármely nyelvből közvetlenül HTTP-n hívható, az OpenAPI-specifikációból pedig openapi-generatorral vagy hasonló eszközzel típusos kliens generálható. Kód nélkül a Certyneo a Make, az n8n, a Postman és a RapidAPI felületén is elérhető.

Kipróbálhatom fizetés nélkül?

Igen: hozzon létre egy ingyenes fiókot, és generáljon sk_test_ kulcsot az irányítópulton. Egy ingyenes fiók első tesztkulcsa egy nap ingyenes Standard csomagot is ad. A Postman-gyűjteménnyel kódírás nélkül futtathatja az első hívásokat.

Mennyibe kerül a EchoSign API (másnév: Adobe Acrobat Sign)?

Az EchoSignt 2011-ben vásárolta meg az Adobe, átnevezte Adobe Signra, majd Adobe Acrobat Signra: az aláírási API ma is létezik, de ára nem nyilvános, és az Adobe értékesítési csapatától kért vállalati árajánlaton keresztül érhető el, jellemzően éves tranzakciós sávok szerint. A Certyneo ezzel szemben nyilvánosan közli árait: az éles API-hozzáférés a 19 €/hó árú Standard csomagtól elérhető, online, árajánlat nélkül rendelhető, és ingyenes tesztkulcsokkal fizetés előtt kipróbálható.

Készen áll az elektronikus aláírás integrálására?

Ingyenes tesztkulcsok, OpenAPI-specifikáció, aláírt webhookok. Kezdje el most.