API podpisu elektronicznego 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

Webhook reagować w czasie rzeczywistym

Sześć zdarzeń (envelope.sent, viewed, signed, completed, declined, expired) z weryfikowalnym podpisem HMAC i automatycznym próbą ponownym.

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 podpis każdego ładunku weryfikuj serwerową autentyczność.

Automatyczne ponowne próby w przypadku niepowodzenia: 5 próbek w ciągu 24 godzin z wykładniczym backoffem.

Dziennik zdarzeń dostępny z pulpitu: zobacz każdą próbę, status HTTP zwrócony, ciało.

URL webhooka konfigurowalny w projekcie na podstawie przeliczenia lub globalnego.

Po co nam API dedykowane do podpisu elektronicznego?

Włączenie podpisu elektronicznego do produktu nie jest łatwe. Potrzebujesz gwarancji zgodności z prawem (eIDAS), rzetelności technicznej (webhooki, które naprawdę przychodzą) i suwerenności danych (europejski hosting w celu uniknięcia ustawy Cloud Act).

Zaprojektowany przez i dla programistów, stosuje się do współczesnych konwencji REST: stronując na podstawie kursu, klucze idempotency, wersyjnowanie na URL, OpenAPI 3.1 do automatycznego generowania klientów.

Zgodność eIDAS wyjaśniona dla deweloperów

Certyneo API umożliwia wybór poziomu na płycie w polu `sygnatura_level`. Domyślna wartość to AES (wystarczająca dla 95% przypadków B2B).

Z technicznego punktu widzenia AES wymaga silnej uwierzytelniania sygnatariusza (default OTP SMS, opcjonalnie KYC wideo) i ścieżki audytu z czasem. QES dodaje kwalifikowany certyfikat wydany przez kwalifikowanego TSP UE. Wszystko to jest obsługiwane przez API dzwonisz do punktu końcowego, reszta się zajmuje.

Zalecana architektura integracji

Najczęściej wzorzec integracji następuje w ten sposób:

Twój backend wywołuje POST /v1/envelopes, aby utworzyć kopertę i otrzymuje sign_url do zaprezentowania użytkownikowi.
Przesyłasz użytkownika do sign_url lub wbudowujesz go w iframe (z brandingem za pośrednictwem planu Pro).
Po zakończeniu podpisu, Certyneo wywołuje twój webhook z wydarzeniem envelope.completed.
Aktualizujesz bazę danych i powiadamiasz użytkownika (email, w aplikacji itp.).

Darmowy Sandbox bez ograniczeń

Środowisko sandbox jest bezpłatne i nieograniczone. Wszystkie funkcje produkcyjne są dostępne, z wyjątkiem podpisów, które nie mają wartości prawnej (PDF jest oznaczony jako SANDBOX). Praktyczne do automatycznych testów, demo klientów, lokalnego rozwoju. Klucze sandbox są oddzielne od kluczy prod, całkowita izolacja między nimi.

Migracja z DocuSign lub Yousign

Jeśli masz już integrację DocuSign lub Yousign, mapowanie API jest proste: koperty → koperty, odbiorcy → odbiorcy, status webhooks → status webhooks. Nasz przewodnik migracji dokumentuje równoważności punktów końcowych.

Migrujesz z Adobe Acrobat Sign (dawniej EchoSign, następnie Adobe Sign)? Mapowanie jest równie bezpośrednie — agreements → envelopes, participants → recipients, webhooks → webhooks. Porównaj Certyneo i Adobe Acrobat Sign →

Cena API podpisu elektronicznego: gdzie kupić subskrypcję?

Pas besoin de devis ni de bon de commande pour acheter un abonnement API de signature : le sandbox est gratuit et illimité, la clé API se génère depuis le dashboard, et l'accès à l'API REST de production est inclus dès le plan Standard à 19 €/mois — webhooks et SDK compris, sans frais par signature.

Standard — 19 €/mois : 100 enveloppes/mois, API REST + webhooks, 10 utilisateurs
Business — 39 €/mois : 300 enveloppes/mois, envoi groupé, formulaires web
Business Pro — 99 €/mois : 1 000 enveloppes/mois, API haute fréquence (300 req/min), utilisateurs illimités

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.

W przypadku dużych wolumenów lub potrzeby zobowiązania umownego (SLA, dedykowana DPA, rozliczenia roczne), plan Enterprise kupuje się u zespołu handlowego. W każdym razie ceny są publiczne — porównaj je przed zaangażowaniem się.

Wystarczy zadać pytania API

Jaki jest limit błędu API?

W przypadku przekroczenia kwoty, API zwraca 429 z retry-After. W przypadku przekroczenia kwoty, API zwraca 429 z retry-After.

Ile kosztuje API?

Le sandbox (clés sk_test_) est gratuit et illimité. L'accès à l'API REST de production est inclus dès le plan Standard à 19 €/mois (100 enveloppes/mois), puis Business à 39 €/mois et Business Pro à 99 €/mois avec des quotas croissants ; la signature qualifiée (QES) est un produit distinct, facturé à l'acte 9,90 € par signature. Pour les volumes supérieurs ou un SLA renforcé, le plan Enterprise se souscrit auprès de l'équipe commerciale.

Czy jest ALS?

99.95% czasu pracy na planach Business i Enterprise (maksymalnie 4 godziny czasu pracy rocznie). Strona publicznego statusu z historią incydentów: status.certyneo.com. Plan Enterprise zawiera automatyczny kredyt w przypadku nieprzestrzegania SLA.

Jakiego typu uwierzytelnianie używasz?

W przypadku integracji OAuth (platforma wieloaktywna) oferujemy OAuth 2.0 Client Credentials na planie Enterprise.

Jak sprawdzić sygnaturę HMAC w sieci?

Każdy webhook zawiera nagłówek X-Certyneo-Signature zawierający HMAC SHA-256 ładunku płatniczego, podpisany z sekretnym webhookiem. Po stronie serwera, przelicz HMAC i porównaj w czasie stałym (timing-safe comparison). Oficjalne SDK robi to automatycznie za pośrednictwem webhook.verify(payload, podpis, sekret).

Czy SDK są otwarte?

Tak. SDK Node, Python i Ruby są na GitHub pod licencją MIT. Możesz je forkować, przyczyniać się do nich lub po prostu je audytować.

Mogę spróbować bez rejestracji?

Tak, za pośrednictwem interaktywnych przykładów z dokumentacji API: /developers/playground. Wnioski są kierowane do instancji sandbox, bez klucza.

Combien coûte l'API EchoSign (devenue Adobe Acrobat Sign) ?

EchoSign a été racheté par Adobe en 2011, renommé Adobe Sign puis Adobe Acrobat Sign : l'API existe toujours, mais son tarif n'est pas public et passe par un devis entreprise auprès de l'équipe commerciale d'Adobe, généralement par tranches de transactions annuelles. À l'inverse, Certyneo affiche ses prix : l'accès API de production est inclus dès le plan Standard à 19 €/mois, souscrit en ligne sans devis, avec un sandbox gratuit illimité pour évaluer l'API avant de payer.

API do podpisu elektronicznego dla programistów

REST + OpenAPI 3.1

Wiarygodne witryny internetowe

Właściwy organ

W przypadku gdy nie jest to możliwe, należy zastosować następujące procedury:

Startowanie w 5 minut.