eIDAS elektronisk signatur-API — 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

Webhooks reagere i realtid

Konvolut- og modtagerhændelserne, verifierbar HMAC-signatur og automatisk genoptagelse.

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 signatur af hver enkelt payload verificere server side.

Automatisk retry ved fiasko: 5 forsøg i 24 timer med eksponentiel backoff.

Eventslog, der kan ses fra dashboarden: se hvert forsøg, den returnerede HTTP-status, kroppen.

Webhook-URL, der kan konfigureres overskrevet eller globalt i projektet.

Hvorfor en API, der er dedikeret til e-signering?

Det er ikke let at integrere en elektronisk signatur i et produkt, men du har brug for garantier for juridisk overensstemmelse (eIDAS), teknisk pålidelighed (webhooks, der virkelig kommer), og datasoverenhed (europæisk hosting for at undgå Cloud Act).

Designet af og til udviklere, følger den moderne REST-konventioner: cursor-baseret paginering, idempotency-nøgler, versionering efter URL, OpenAPI 3.1 til at generere dine klienter automatisk.

eIDAS-overensstemmelse forklaret til udviklere

eIDAS-forordningen definerer tre signaturniveauer: enkel (SES), avanceret (AES) og kvalificeret (QES). Certyneo API giver mulighed for at vælge niveauet pr. konvolut via et felt `signature_level`. Standardværdien er AES (tilstrækkelig i 95% af B2B-sager). QES er tilgængelig for dokumenter, der kræver streng juridisk ligestilling med håndskreven underskrift (notarialdokumenter, offentlige udbud).

Teknisk set kræver AES en stærk autentisering af signeren (OTP via SMS som standard, KYC video som en mulighed) og en tidstemplet audittrail. QES tilføjer et kvalificeret certifikat udstedt af en EU-kvalificeret TSP. Alt dette håndteres af API du ringer til slutpunktet, vi tager os af resten.

Anbefalet integrationsarkitektur

Det mest almindelige integrationsmønster følger denne strøm:

Din backend kalder POST /v1/envelopper for at oprette enveloppen og modtager et sign_url til at præsentere for brugeren.
Du kan redirecere brugeren til sign_url eller indlejre den i iframe (med dit branding via Pro-planen).
Når signaturen er færdig, ringer Certyneo til dit webhook med en event som hedder envelope.completed.
Du opdaterer din database og giver brugeren besked (e-mail, i-app osv.).

Sandkasse gratis ubegrænset

Sandbox-miljøet er gratis og ubegrænset. Alle produktionsfunktioner er tilgængelige, bortset fra at signaturer ikke har juridisk værdi (PDF er markeret som SANDBOX). Praktisk til automatiserede tests, klientdemonstrationer, lokal udvikling. Sandbox-nøgler er adskilt fra prod-nøgler, total isolation mellem de to.

Og hvis du ikke ønsker at skrive kode

Alt det, som denne API gør, kan også styres uden at skrive en linje fra et flow: oprette en kuvert, sende den, reagere på en underskrift, hente det forseglede PDF og dets revisionsspor. Samme grundlag, med en visuelt designer i stedet for HTTP-klienten. Se Power Automate- og Microsoft 365-integrationen.

Flyt fra DocuSign eller Yousign

Hvis du allerede har en DocuSign eller Yousign integration, er API-mappingen direkte: konvolutter → konvolutter, modtagere → modtagere, status webhooks → status webhooks. Vores migrationsvejledning dokumenterer endpoint-for-endpoint-ligestillinger.

Migrerer du fra Adobe Acrobat Sign (tidligere EchoSign, derefter Adobe Sign)? Kortlægningen er lige så direkte — agreements → envelopes, participants → recipients, webhooks → webhooks. Sammenlign Certyneo og Adobe Acrobat Sign →

Pris på et API til elektronisk signatur: hvor køber man et abonnement?

Intet behov for tilbud eller indkøbsordre for at købe et API-abonnement til underskrift: sandkassen er gratis og ubegrænset, API-nøglen genereres fra dashboard'et, og adgang til produktions-REST API er inkluderet fra Standard-planen på 19 €/mdr — webhooks og SDK inkluderet, uden gebyrer pr. underskrift.

Standard — 19 €/mdr: 100 konvolutter/mdr, REST API + webhooks, 10 brugere
Business — 39 €/mdr: 300 konvolutter/mdr, gruppeforsendelse, webformularer
Business Pro — 99 €/mdr: 1.000 konvolutter/mdr, høj-frekvens API (300 req/min), ubegrænsede brugere

QES (kvalificeret elektronisk skrift) er en separat produkt, faktureret pr. signatur: 9,90 € pr. signatur, tilgængelig på alle pakker, inklusive Gratuit.

For store mængder eller behov for kontraktlig forpligtelse (SLA, dedikeret DPA, årlig fakturering) tegnes Enterprise-planen via salgsteamet. I alle tilfælde er priserne offentlige — sammenlign dem før du forpligter dig.

Fejr med spørgsmål API

Hvad er API'ens sporegrænse?

1000 forespørgsler pr. minut som standard, forhøjet efter behov for høje anvendelsesniveauer (fabrikker, multi-tenant platforme). X-RateLimit-Remaining-overskriften på hvert svar angiver den resterende kvote. Hvis denne overskrides, returnerer API 429 med et Retry-After.

Hvad koster API'en?

Sandkassen (nøgler sk_test_) er gratis og ubegrænset. Adgang til produktions-REST API er inkluderet fra Standard-planen på 19 €/mdr (100 konvolutter/mdr), derefter Business på 39 €/mdr og Business Pro på 99 €/mdr med stigende kvoter; kvalificeret underskrift (QES) er et særskilt produkt, faktureret pr. handling 9,90 € pr. underskrift. For større volumener eller forstærket SLA abonneres Enterprise-planen hos handelsteamet.

Er der ALS?

99,95 % optid på Business og Enterprise-planerne (maksimalt 4 timers nedetid om året).

Hvilken autentificering bruger du?

Bearer token (API-nøgle) i autorisationsoverskriften. Nøglerne kan drejes fra dashboarden, med øjeblikkelig tilbagekaldelse. For OAuth-integrationer (multi-stakeholder platform) tilbyder vi en OAuth 2.0 Client Credentials på Enterprise-plan.

Hvordan kontrollerer man en webhooks HMAC-signatur?

Hver webhook indeholder en X-Certyneo-Signature-overskrift med en HMAC SHA-256 af payloadet, underskrevet med dit hemmelige webhook. På serversiden, omregnes HMAC og sammenlignes i konstant tid (timing-safe sammenligning). Den officielle SDK gør dette automatisk via webhook.verify(payload, signatur, hemmelighed).

Er SDK'erne open source?

Ja. Node, Python og Ruby SDK'erne er på GitHub under MIT-licens. Du kan forker, bidrage eller bare auditere dem. Binærerne er udgivet på npm, PyPI og RubyGems under navnespørgsmålet @certyneo / certyneo.

Må jeg prøve uden at være registreret?

Ja, via de interaktive eksempler i API-dokumentationen: /developers/playground. Der går forespørgsler mod en delt sandboksinstance, uden at der kræves nøgle. For seriøs brug oprette en gratis udviklerkonto (ubegrænset sandboks).

Hvad koster EchoSign API (blevet Adobe Acrobat Sign)?

EchoSign blev købt af Adobe i 2011, omdøbt til Adobe Sign derefter Adobe Acrobat Sign: API'en eksisterer stadig, men dens pris er ikke offentlig og kræver et virksomhedstilbud fra Adobe's handelsteam, normalt efter årlige transaktionsblokke. I modsætning hertil offentliggør Certyneo sine priser: produktions-API adgang er inkluderet fra Standard-planen på 19 €/mdr, tegnet online uden tilbud, med en gratis ubegrænset sandkasse til at evaluere API'en før betaling.

E-signering API til udviklere

REST + OpenAPI 3.1

Pålidelige webshocks

Native eIDAS-overensstemmelse

Læsenhed < 200 ms

Start om fem minutter.