REST API — eIDAS

De API voor elektronische handtekeningen voor ontwikkelaars

Integreer eIDAS elektronische handtekeningen in uw applicatie in enkele uren. REST, betrouwbare webhooks, SDK Node/Python/Ruby, onbeperkte gratis sandbox.

Maak een ontwikkelaarsaccount aan API-documentatie

Gratis sandbox · 99,95% uptime · Soevereine EU-hosting

REST + OpenAPI 3.1

Voorspelbare endpoints, schone JSON, standaard HTTP-codes. OpenAPI 3.1-specificatie kan worden gedownload om uw eigen clients te genereren.

Betrouwbare webhooks

Automatische retry met exponentiële backoff, HMAC SHA-256-ondertekening, raadpleegbaar gebeurtenissenlogboek. Geen polling om te coderen.

Native eIDAS-conformiteit

AES-, AES-Q- en QES-handtekeningen beschikbaar via API-vlag. Gekwalificeerde audittrail inbegrepen, gekwalificeerde EU TSP-certificaten.

Latentie < 200 ms

API gehost in Straatsburg (EU), p95 < 200 ms vanuit Europa. SLA 99,95% uptime, openbare realtime-status.

Starten in 5 minuten

Maak uw eerste envelop aan met slechts één HTTP-verzoek.

cURL — Envelop aanmaken

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

Eén POST-verzoek volstaat om een envelop te maken, een document toe te voegen, een ondertekenaar toe te voegen en de webhook-URL in te stellen. De API retourneert een sign_url klaar om te delen.

Officiële Node.js SDK

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

De Node TypeScript SDK biedt volledige typering, automatische foutafhandeling met retry, en een vloeiende envelope builder. Ook beschikbaar in Python en Ruby.

Webhooks — reageer in real-time

De envelop- en geadresseerde-gebeurtenissen, verifieerbare HMAC-handtekening en automatisch opnieuw proberen.

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 handtekening van elke payload — verifieer de authenticiteit aan serverzijde.
Automatische retry bij falen: 5 pogingen over 24 uur met exponentiële backoff.
Event log raadpleegbaar vanuit het dashboard: zie elke poging, geretourneerde HTTP-status, de body.
Webhook URL configureerbaar per envelope (override) of globaal in het project.

Waarom een API specifiek voor elektronische handtekeningen?

Het integreren van elektronische handtekeningen in uw product is niet triviaal. U hebt garanties nodig over wettelijke naleving (eIDAS), technische betrouwbaarheid (webhooks die echt binnenkomen), en datasouvereiniteit (Europese hosting om de Cloud Act te vermijden). De Certyneo API dekt alle drie.

Ontworpen door en voor ontwikkelaars, volgt deze moderne REST-conventies: cursor-based paginering, idempotency keys, versioning via URL, OpenAPI 3.1 om uw clients automatisch te genereren. Geen SOAP, geen XML, geen verrassingen.

eIDAS-naleving uitgelegd voor ontwikkelaars

De eIDAS-verordening definieert drie handtekeningniveaus: eenvoudig (SES), geavanceerd (AES) en gekwalificeerd (QES). De Certyneo API stelt u in staat het niveau per envelope te kiezen via een `signature_level` veld. De standaardwaarde is AES (voldoende voor 95% van de B2B-gevallen). QES is beschikbaar voor documenten die strikte wettelijke gelijkwaardigheid met handmatige handgeschreven handtekeningen vereisen (notariële akten, openbare aanbestedingen).

Technisch gezien vereist AES sterke authenticatie van de ondertekenaar (OTP per SMS standaard, video KYC als optie) en een tijdgestempeld auditspoor. QES voegt een gekwalificeerd certificaat toe, uitgegeven door een gekwalificeerde EU TSP. Dit alles wordt door de API beheerd — u roept het endpoint aan, wij regelen de rest.

Aanbevolen integratiearchitectuur

Het meest voorkomende integratiepatroon volgt deze flow:

Uw backend roept POST /v1/envelopes aan om de envelope te maken en ontvangt een sign_url die aan de gebruiker moet worden gepresenteerd.
U leidt de gebruiker om naar sign_url of embedt deze in een iframe (met uw branding via het Pro-plan).
Zodra de handtekening is voltooid, roept Certyneo uw webhook aan met het envelope.completed event.
U werkt uw database bij en stelt de gebruiker op de hoogte (e-mail, in-app, enz.).

Gratis onbeperkte sandbox

De sandbox-omgeving is gratis en onbeperkt. Alle productiefuncties zijn beschikbaar, behalve dat handtekeningen geen juridische waarde hebben (de PDF is gemarkeerd als SANDBOX). Handig voor geautomatiseerde tests, klantdemo's en lokale ontwikkeling. Sandbox-sleutels zijn gescheiden van productie-sleutels, volledige isolatie tussen de twee.

En als u geen code wilt schrijven

Alles wat deze API doet, kan ook zonder code worden beheerd via een stroom: een omslag maken, verzenden, reageren op een handtekening, de verzegelde PDF en audittrail ophalen. Dezelfde basis, met een visuele ontwerper in plaats van een HTTP-client. Zie de Power Automate- en Microsoft 365-integratie.

Migreren van DocuSign of Yousign

Als u al een DocuSign- of Yousign-integratie heeft, is de API-toewijzing direct: envelopes → envelopes, recipients → recipients, status webhooks → status webhooks. Onze migratiehandleiding documenteert de equivalenties endpoint voor endpoint. Reken op 1 tot 3 dagen voor een volledige migratie, veel minder als u een interne wrapper gebruikt.

Migreert u van Adobe Acrobat Sign (voorheen EchoSign, daarna Adobe Sign)? De mapping is even eenvoudig — agreements → envelopes, participants → recipients, webhooks → webhooks. Certyneo en Adobe Acrobat Sign vergelijken →

Prijs van een API voor elektronische handtekeningen: waar een abonnement kopen?

Geen offerte of inkooporder nodig om een API-ondertekeningsabonnement aan te schaffen: de sandbox is gratis en onbeperkt, de API-sleutel wordt gegenereerd vanuit het dashboard, en toegang tot de productie-REST-API is inbegrepen vanaf het Standard-plan op 19 €/maand — webhooks en SDK inbegrepen, geen kosten per ondertekening.

Standard — 19 €/maand: 100 enveloppen/maand, REST-API + webhooks, 10 gebruikers
Business — 39 €/maand: 300 enveloppen/maand, batchverzending, webformulieren
Business Pro — 99 €/maand: 1.000 enveloppen/maand, high-frequency API (300 req/min), onbeperkte gebruikers

De gekwalificeerde handtekening (QES) is een afzonderlijk product, gefactureerd per handtekening: 9,90 € per handtekening, beschikbaar op alle abonnementen, inclusief Gratis.

Voor grote volumes of behoefte aan contractuele verplichting (SLA, toegewezen DPA, jaarlijkse facturering), wordt het Enterprise-plan afgesloten met het verkoopteam. In alle gevallen zijn de prijzen openbaar — vergelijk ze voordat u zich verbindt.

Veelgestelde vragen — API

Wat is de rate limit van de API?

1.000 verzoeken per minuut standaard, op verzoek verhoogbaar voor intensief gebruik (factories, multi-tenant-platforms). De header X-RateLimit-Remaining op elk antwoord geeft het resterende quotum aan. Bij overschrijding retourneert de API 429 met een Retry-After.

Hoeveel kost de API?

De sandbox (sleutels sk_test_) is gratis en onbeperkt. Toegang tot de REST-API voor productie is inbegrepen vanaf het Standard-plan op 19 €/maand (100 enveloppen/maand), vervolgens Business op 39 €/maand en Business Pro op 99 €/maand met stijgende quota's; gekwalificeerde ondertekening (QES) is een apart product, gefactureerd per handeling op 9,90 € per ondertekening. Voor hogere volumes of versterkte SLA kunt u het Enterprise-plan afsluiten via het verkoopsteam.

Is er een SLA?

99,95% uptime op Business- en Enterprise-abonnementen (maximaal 4 uur downtime per jaar). Openbare statuspagina met incidentgeschiedenis: status.certyneo.com. Het Enterprise-plan bevat automatisch tegoed in geval van SLA-niet-naleving.

Welke authenticatie gebruikt u?

Bearer token (API-sleutel) in de Authorization-header. Sleutels kunnen van het dashboard worden rouleren, met onmiddellijke intrekking. Voor OAuth-integraties (multi-tenant-platform) bieden we OAuth 2.0 Client Credentials op het Enterprise-plan.

Hoe controleer ik de HMAC-handtekening van een webhook?

Elke webhook bevat een X-Certyneo-Signature-header met een HMAC SHA-256 van de payload, ondertekend met uw webhook-geheim. Aan serverzijde berekent u de HMAC opnieuw en vergelijkt u in constante tijd (timing-safe comparison). De officiële SDK doet dit automatisch via webhook.verify(payload, signature, secret).

Zijn de SDK's open source?

Ja. De Node-, Python- en Ruby-SDK's staan op GitHub onder de MIT-licentie. U kunt forken, bijdragen of ze eenvoudig controleren. De binaries worden gepubliceerd op npm, PyPI en RubyGems onder de naamruimte @certyneo / certyneo.

Kan ik testen zonder inschrijving?

Ja, via de interactieve voorbeelden in de API-documentatie: /developers/playground. Verzoeken worden daar uitgevoerd tegen een gedeelde sandbox-instantie, zonder sleutel vereist. Voor serieus gebruik maakt u een gratis ontwikkelaarsaccount aan (onbeperkte sandbox).

Hoeveel kost de EchoSign-API (nu Adobe Acrobat Sign)?

EchoSign werd in 2011 overgenomen door Adobe, hernoemd naar Adobe Sign en vervolgens Adobe Acrobat Sign: de API bestaat nog steeds, maar de prijs is niet openbaar en gaat via een zakelijke offerte van het verkoopteam van Adobe, meestal per tranches van jaarlijkse transacties. Certyneo daarentegen geeft zijn prijzen duidelijk aan: toegang tot de productie-API is inbegrepen vanaf het Standard-plan op 19 €/maand, online ingeschreven zonder offerte, met een gratis onbeperkte sandbox om de API eerst te evalueren voordat u betaalt.

Klaar om elektronische handtekening te integreren?

Onbeperkte gratis sandbox, volledige documentatie, officiële SDK's. Start nu.

Lees de documentatie Spreek met een Certyneo-ontwikkelaar