E-signatur-API 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

Webhooks reagera i realtid

Sex händelser (envelope.sent, viewed, signed, completed, declined, expired) med verifierbar HMAC-signatur och automatisk retry.

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 för varje last verifiera server-sidans autentisering.

Automatisk retry vid misslyckande: 5 försök under 24 timmar med exponentiell backoff.

Eventslogg som kan sökas från instrumentpanelen: se varje försök, återlämnat HTTP-status, kropp.

Webhook-URL som kan konfigureras överskrivs eller globalt i projektet.

Varför en API för e-signaturer?

Det är inte lätt att integrera en e-signering i en produkt. Du behöver garantier för laglig överensstämmelse (eIDAS), teknisk tillförlitlighet (webhok som verkligen kommer), och datasovärdighet (europeisk hosting för att undvika molnet).

Den är utformad av och för utvecklare och följer de moderna REST-konventionerna: cursorbaserad paginering, idempotency-nycklar, versionering per URL, OpenAPI 3.1 för att generera dina kunder automatiskt.

eIDAS-efterlevnad förklarad för utvecklare

Certyneo API gör det möjligt att välja nivå per kuvert via ett fält `signature_level`. Standardvärdet är AES (tillräckligt för 95% av B2B-fall).

AES kräver en stark autentisering av signaten (OTP via textmeddelande som standard, KYC video som alternativ) och en tidstämplad audittrail. QES lägger till ett kvalificerat certifikat från en EU-kvalificerad TSP. Allt detta hanteras av API du ringer endpunkten, vi tar hand om resten.

Rekommenderad integrationsarkitektur

Det vanligaste integrationsmönstret är följande:

Din backend ringer POST /v1/envelopes för att skapa kuverten och får ett sign_url att presentera för användaren.
Du kan leda användaren till sign_url eller bädda in den i iframe (med din branding via Pro-planen).
När signaturen är klar ringer Certyneo din webhook med händelsen envelope.completed.
Du uppdaterar din databas och meddelar användaren (e-post, in-app, etc.).

Sandbox gratis obegränsad

Sandbox-miljön är gratis och obegränsad. Alla produktionsfunktioner är tillgängliga, utom att signaturerna inte har lagligt värde (PDF är markerad som SANDBOX). Praktiskt för automatiserade tester, kunddemonstrationer, lokal utveckling. Sandbox-nycklar är separata från prod-nycklar, total isolering mellan de två.

Flytta från DocuSign eller Yousign

Om du redan har en DocuSign- eller Yousign-integration är API-mappningen enkel: kuvert → kuvert, mottagare → mottagare, status webhooks → status webhooks. Vår migrationsguide dokumenterar endpoint-för-endpoint-likvärdigheterna.

Du migrerar från Adobe Acrobat Sign (tidigare EchoSign, sedan Adobe Sign)? Mappningen är lika direkt — agreements → envelopes, participants → recipients, webhooks → webhooks. Jämför Certyneo och Adobe Acrobat Sign →

Pris för ett API för elektronisk signering: var köper man ett abonnemang?

Inget behov av offert eller inköpsorder för att köpa en API-signeringsprenumeration: sandlådan är gratis och obegränsad, API-nyckeln genereras från instrumentpanelen, och åtkomst till produktions-REST-API:n ingår redan från Standard-planen på 19 €/månad — webhooks och SDK inkluderade, utan avgifter per signatur.

Standard — 19 €/månad: 100 kuvert/månad, REST-API + webhooks, 10 användare
Business — 39 €/månad: 300 kuvert/månad, gruppöverföring, webbformulär
Business Pro — 99 €/månad: 1 000 kuvert/månad, högfrekvent API (300 req/min), obegränsade användare

La signature qualifiée (QES) est un produit distinct, facturée à l'acte : 9,90 € par signature, disponible sur tous les forfaits, y compris Gratuit.

För stora volymer eller behov av kontraktsbindning (SLA, dedikerad DPA, årlig fakturering) tecknas Enterprise-planen via försäljningsteamet. I alla fall är priserna offentliga — jämför dem innan du åtar dig något.

Frågorna är inte bra API

Vad är gränsen för API?

1 000 förfrågningar per minut som standard, kan ökas på begäran för höga användningar (fabriker, multi-tenant plattformar). X-RateLimit-Remaining-huvudet på varje svar anger kvarvarande kvot. Om kvoten överskrids returnerar API 429 med ett Retry-After.

Vad kostar API:et?

Sandlådan (nycklar sk_test_) är gratis och obegränsad. Åtkomst till produktions-REST-API:n ingår redan från Standard-planen på 19 €/månad (100 kuvert/månad), sedan Business på 39 €/månad och Business Pro på 99 €/månad med växande kvoter; kvalificerad signatur (QES) är en separat produkt, fakturerad per åtgärd 9,90 € per signatur. För större volymer eller förstärkat SLA tecknas Enterprise-planen hos försäljningsteamet.

Finns det ALS?

99,95 procent upptid på Business och Enterprise-planerna (max 4 timmars nedtid per år). Public status sida med incidenthistorik: status.certyneo.com. Enterprise-planen innehåller automatisk kredit för brott mot SLA.

Vilken autentisering använder ni?

Bearer token (API-nyckel) i Authorization-huvudet. Nycklarna kan rullas från instrumentpanelen, med omedelbar återkallelse. För OAuth-integrationer (multi-stakeholder-plattform) erbjuder vi en OAuth 2.0 Client Credentials på Enterprise-planen.

Hur kan man verifiera en webhooks HMAC-signatur?

Varje webhook innehåller en X-Certyneo-Signature-header som innehåller en HMAC SHA-256 av payload, signerad med din hemliga webhook. På serversidan, omräkna HMAC och jämföra i konstant tid (timing-safe comparison).

Är SDK:n öppen källkod?

Ja. Node, Python och Ruby SDK finns på GitHub med MIT-licens. Du kan forka, bidra eller helt enkelt granska dem.

Kan jag testa utan att registrera mig?

Ja, via de interaktiva exemplen i API-dokumentationen: /developers/playground. Där går förfrågningar mot en delad sandboxinstans, utan nyckel. För seriös användning, skapa ett gratis utvecklarkonto (obegränsad sandbox).

Hur mycket kostar EchoSign-API:n (som blev Adobe Acrobat Sign)?

EchoSign köptes av Adobe 2011, döptes om till Adobe Sign sedan Adobe Acrobat Sign: API:n finns fortfarande kvar, men dess pris är inte offentligt och går genom en företagsoffert från Adobes försäljningsteam, vanligtvis per årliga transaktionsblock. Däremot visar Certyneo sina priser: produktions-API-åtkomst ingår redan från Standard-planen på 19 €/månad, tecknad online utan offert, med en gratis obegränsad sandlåda för att utvärdera API:n innan du betalar.

E-signatur-API för utvecklare

REST + OpenAPI 3.1

Tillförlitliga webbhooks

EIDAS-nativ överensstämmelse

Längd < 200 ms

Start om fem minuter.