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

Zdarzenia koperty i odbiorcy, weryfikowalna sygnatura HMAC i automatyczne przypomnienia.

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

Rozporządzenie eIDAS definiuje trzy poziomy podpisu: prosty (SES), zaawansowany (AES) i kwalifikowany (QES). Certyneo API umożliwia wybór poziomu dla każdej koperty w polu `signature_level`. Domyślna wartość to AES (wystarczająca dla 95% przypadków B2B). QES jest dostępny dla czynności wymagających ścisłej równoważności prawnej z podpisem odręcznym (akty notarialne, zamówienia publiczne).

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.

A jeśli nie chcesz pisać kodu

Wszystko, co robi ten API, można również kontrolować bez pisania linijki kodu, z poziomu przepływu: utworzyć kopertę, wysłać ją, reagować na podpis, pobrać zapieczętowany plik PDF i jego ścieżkę audytu. Ta sama podstawa, z wizualnym projektantem zamiast klienta HTTP. Wyświetl integrację Power Automate i Microsoft 365.

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ę?

Nie potrzebujesz wyceny ani zamówienia, aby kupić abonament API podpisów: piaskownica jest bezpłatna i nieograniczona, klucz API generuje się z panelu, a dostęp do produkcyjnego API REST jest zawarty już w planie Standard za 19 €/miesiąc — webhooks i SDK w cenie, bez opłat za podpis.

Standard — 19 €/miesiąc: 100 kopert/miesiąc, API REST + webhooks, 10 użytkowników
Business — 39 €/miesiąc: 300 kopert/miesiąc, wysyłka grupowa, formularze internetowe
Business Pro — 99 €/miesiąc: 1 000 kopert/miesiąc, API o wysokiej częstotliwości (300 żąd./min), nieograniczeni użytkownicy

Podpis kwalifikowany (QES) to oddzielny produkt, rozliczany na zasadzie za akt: 9,90 € za podpis, dostępny na wszystkich planach, w tym Darmowym.

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?

Piaskownica (klucze sk_test_) jest bezpłatna i nieograniczona. Dostęp do produkcyjnego API REST jest zawarty w planie Standard za 19 €/miesiąc (100 kopert/miesiąc), następnie Business za 39 €/miesiąc i Business Pro za 99 €/miesiąc z rosnącymi limitami; podpis kwalifikowany (QES) to oddzielny produkt, rozliczany na zasadzie za akt 9,90 € za podpis. Dla większych wolumenów lub wzmocnionej umowy SLA plan Enterprise jest zamawiany u zespołu handlowego.

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.

Ile kosztuje API EchoSign (teraz Adobe Acrobat Sign)?

EchoSign został zakupiony przez Adobe w 2011 roku, przemianowany na Adobe Sign, a następnie Adobe Acrobat Sign: API nadal istnieje, ale jego cena nie jest publiczna i odbywa się poprzez wycenę dla przedsiębiorstw u zespołu handlowego Adobe, zwykle w transzach rocznych transakcji. Z kolei Certyneo publikuje swoje ceny: dostęp do API produkcyjnego jest zawarty już w planie Standard za 19 €/miesiąc, zamawiany online bez wyceny, z bezpłatną i nieograniczoną piaskownicą do oceny API przed zapłatą.

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.