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 sanntid

Konvolutt- og mottakerhendelser, verifiserbar HMAC-signatur og automatisk påminnelse.

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 av hver payload verifisere autentisitet på serversiden.

Automatisk retry ved feil: 5 forsøk i 24 timer med eksponentiell backoff.

Eventsjournal som kan ses fra dashbordet: se hvert forsøk, returnerte HTTP-status, kroppen.

Webhook-URL som kan konfigureres overskrevet eller globalt i prosjektet.

Hvorfor en API som er dedikert til e-signaturer?

Det er ikke lett å integrere en elektronisk signatur i produktet ditt. Du trenger garantier for juridisk samsvar (eIDAS), teknisk pålitelighet (webhooks som virkelig kommer), og datasoverenhet (europeisk hosting for å unngå Cloud Act).

Den er utviklet av og for utviklere, og følger moderne REST-konvensjoner: kursorbasert paginering, idempotency-nøklene, versjonering per URL, OpenAPI 3.1 for å generere kundene dine automatisk.

eIDAS-overensstemmelse forklart for utviklere

eIDAS-forordningen definerer tre signaturnivåer: enkel (SES), avansert (AES) og kvalifisert (QES). Certyneo API lar deg velge nivået per konvolutt via et felt `signature_level`. Standardverdien er AES (tilstrekkelig for 95% av B2B-sakene). QES er tilgjengelig for dokumenter som krever streng juridisk likestilling med håndskrevet underskrift (notarialdokumenter, offentlige anskaffelser).

Teknisk sett krever AES sterk autentisering av signaturen (OTP via SMS som standard, KYC video som valg) og en tidstemplet auditrute. QES legger til et kvalifisert sertifikat fra en EU-kvalifisert TSP. Alt dette håndteres av API du ringer endpunktet, vi tar oss av resten.

Anbefalt integrasjonsarkitektur

Det vanligste integrasjonsmønsteret følger denne strømmen:

Bakendet ditt ringer POST /v1/envelopes for å lage konvolutten og får et sign_url for å presentere til brukeren.
Du kan sende brukeren til sign_url eller legge inn i iframe (med din branding via Pro-planen).
Når signaturen er fullført, ringer Certyneo webhook med en event som heter envelope.completed.
Du oppdaterer databasen din og varsler brukeren (e-post, i-app, etc.).

Sandkasse gratis ubegrenset

Sandbox-miljøet er gratis og ubegrenset. Alle produksjonsfunksjoner er tilgjengelige, med unntak av at signaturene ikke har juridisk verdi (PDF er merket SANDBOX). Praktisk for automatisert testing, klientdemonstrasjoner, lokal utvikling. Sandbox-nøkler er adskilt fra prod-nøkler, total isolasjon mellom de to.

Og hvis du ikke vil skrive kode

Alt som denne API-en gjør kan også styres uten å skrive en linje, fra en arbeidsflyt: opprett en konvolutt, send den, reagér på en signatur, hent den forseglete PDF-en og revisjonsloggen. Samme grunnlag, med en visuell designer i stedet for HTTP-klienten. Se Power Automate og Microsoft 365-integrasjonen.

Migrer fra DocuSign eller Yousign

Hvis du allerede har en DocuSign eller Yousign integrasjon, er kartlegging API direkte: konvolutter → konvolutter, mottakere → mottakere, status webhooks → status webhooks.

Du migrerer fra Adobe Acrobat Sign (tidligere EchoSign, deretter Adobe Sign) ? Kartleggingen er like direkte — agreements → envelopes, participants → recipients, webhooks → webhooks. Sammenligne Certyneo og Adobe Acrobat Sign →

Pris for et API for elektronisk signatur: hvor kjøpe et abonnement?

Ingen behov for tilbud eller bestillingskvittering for å kjøpe et API-signeringsabonnement: sandkassen er gratis og ubegrenset, API-nøkkelen genereres fra dashbordet, og tilgang til produksjons-REST-API er inkludert fra Standard-planen på 19 €/mnd — webhooks og SDK inkludert, ingen gebyr per signatur.

Standard — 19 €/mnd: 100 konvolutter/mnd, REST-API + webhooks, 10 brukere
Business — 39 €/mnd: 300 konvolutter/mnd, gruppesending, webskjemaer
Business Pro — 99 €/mnd: 1 000 konvolutter/mnd, høyfrekvens-API (300 forespørsler/min), ubegrensede brukere

Kvalifisert signatur (QES) er et eget produkt som faktureres per akt: 9,90 € per signatur, tilgjengelig på alle pakker, inkludert Gratis.

For større volum eller behov for kontraktsmessig forpliktelse (SLA, dedikert DPA, årlig fakturering), tegnes Enterprise-planen hos salgsteamet. I alle tilfeller er prisene offentlige — sammenlign dem før du forplikter deg.

Fære til spørsmål API

Hva er API-grensens?

1000 forespørsler per minutt som standard, økes på forespørsel for høye bruksområder (fabrikker, multi-tenant plattformer). X-RateLimit-Remaining-overskriften på hvert svar viser restkvoten. Hvis den overskrides, returnerer API 429 med Retry-After.

Hvor mye koster API?

Sandkassen (nøkler sk_test_) er gratis og ubegrenset. Tilgang til produksjons-REST-API er inkludert fra Standard-planen på 19 €/mnd (100 konvolutter/mnd), deretter Business på 39 €/mnd og Business Pro på 99 €/mnd med økende kvoter; kvalifisert signatur (QES) er et eget produkt, fakturert per handling 9,90 € per signatur. For større volumer eller forsterket SLA abonneres Enterprise-planen hos salgsteamet.

Er det noen ALS?

99,95 prosent opptid på Business og Enterprise planene (maksimalt 4 timers nedtid per år). Offentlig statusside med hendelseshistorie: status.certyneo.com. Enterprise plan inkluderer automatisk kreditt ved ikke-overholdelse av SLA.

Hvilken autentisering bruker du?

Bearer token (API-nøkkel) i Authorization-overskriften. Nøklene kan snurres fra dashboardet, med umiddelbar tilbakekalling. For OAuth-integrasjoner (multi-stakers plattform) tilbyr vi en OAuth 2.0 Client Credentials på Enterprise-planen.

Hvordan sjekker man HMAC-signaturen på et webhook?

Hver webhook inneholder en X-Certyneo-Signature-overskrift som inneholder en HMAC SHA-256 av payload, signert med ditt hemmelige webhook.

Er SDK-ene åpen kildekode?

Ja. Node, Python og Ruby SDK er på GitHub under MIT lisens. Du kan forker, bidra eller bare revidere dem. Binærene er publisert på npm, PyPI og RubyGems under navnsplassen @certyneo / certyneo.

Kan jeg prøve uten å registrere meg?

Ja, via de interaktive eksemplene i API-dokumentasjonen: /developers/playground. Her går forespørsler mot en delt sandboksinstans, uten nøkkel. For seriøs bruk, opprett en gratis utviklerkonto (ubegrenset sandboks).

Hva koster EchoSign-API (blitt Adobe Acrobat Sign)?

EchoSign ble kjøpt opp av Adobe i 2011, omdøpt til Adobe Sign deretter Adobe Acrobat Sign: API-en eksisterer fortsatt, men prisen er ikke offentlig og går gjennom et foretaksbudsjett hos Adobes salgsteam, vanligvis etter årlige transaksjonstrancher. Tvert imot publiserer Certyneo prisene sine: tilgang til produksjons-API er inkludert fra Standard-planen på 19 €/mnd, abonnert online uten tilbud, med en ubegrenset gratis sandkasse for å evaluere API-en før betaling.

E-signerings-API for utviklere

REST + OpenAPI 3.1

Pålitelige webhooks

EIDAS-native samsvar

Latens < 200 ms

Start om fem minutter.