API REST — eIDAS

Το ηλεκτρονικό υπογραφικό API για προγραμματιστές

Ενσωματώστε την ηλεκτρονική υπογραφή eIDAS στην εφαρμογή σας σε λίγες ώρες. REST, αξιόπιστα webhooks, SDK Node/Python/Ruby, απεριόριστο δωρεάν sandbox.

Δημιουργήστε λογαριασμό προγραμματιστή Επισκόπηση API

Δωρεάν Sandbox · 99,95% uptime · ΕΕ κυρίαρχη φιλοξενία

REST + OpenAPI 3.1

Προβλεψιμα endpoints, καθαρό JSON, τυποποιημένος κώδικας HTTP. Spec OpenAPI 3.1 που μπορείτε να κατεβάσετε για να δημιουργήσετε τους δικούς σας πελάτες.

Αξιόπιστα webhooks

Αυτόματη αναζήτηση με εκθετικό backup, υπογραφή HMAC SHA-256, αναζητούμενο ημερολόγιο γεγονότων.

Εγγύηση για την εφαρμογή της διαδικασίας eIDAS

Υπογραφές AES, AES-Q και QES διαθέσιμες μέσω API flag.

Ηλεκτρική ροή

API που φιλοξενείται στο Στρασβούργο (ΕΕ), p95 < 200 ms από την Ευρώπη.

Ξεκινάμε σε 5 λεπτά.

Δημιουργήστε το πρώτο σας φάκελο με ένα μόνο αίτημα HTTP.

cURL Δημιουργία ενός φακέλου

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"
  }'

Μια POST αίτηση είναι αρκετή για να δημιουργηθεί ένα φάκελο, να προστεθεί ένα έγγραφο, ένας υπογράφων και το URL webhook.

Επίσημο SDK Node.js

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

Το Node TypeScript SDK παρέχει πλήρη πληκτρολόγηση, αυτόματη διαχείριση σφαλμάτων με επαναπροσπάθεια και κατασκευαστή υγρού περιτύπου.

Webhooks αντιδράστε σε πραγματικό χρόνο

Τα γεγονότα φακέλου και παραλήπτη, επαληθεύσιμη υπογραφή HMAC και αυτόματη αναζήτηση.

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 κάθε φορτίου επιβεβαίωσε την αυθεντικότητα από την πλευρά του διακομιστή.
Αυτόματη επαναπροσπάθεια σε περίπτωση αποτυχίας: 5 προσπάθειες σε 24 ώρες με εκθετικό backoff.
Ημερολόγιο γεγονότων αναζητούμενο από το πίνακα ελέγχου: βλέπετε κάθε προσπάθεια, την κατάσταση HTTP που επιστρέφεται, το σώμα.
URL webhook που μπορεί να ρυθμιστεί σε υπεράκτιση ή σε παγκόσμιο επίπεδο στο έργο.

Γιατί να δημιουργήσουμε έναν API για ηλεκτρονική υπογραφή;

Η ενσωμάτωση της ηλεκτρονικής υπογραφής στο προϊόν σας δεν είναι εύκολη υπόθεση. Χρειάζεστε εγγυήσεις για τη νομική συμμόρφωση (eIDAS), την τεχνική αξιοπιστία (webhooks που έρχονται πραγματικά) και την κυριαρχία των δεδομένων (ευρωπαϊκή φιλοξενία για να αποφύγετε το νόμο Cloud).

Σχεδιασμένο από και για προγραμματιστές, ακολουθεί τις σύγχρονες συμβάσεις REST: pagination με βάση το cursor, idempotency keys, versioning με URL, OpenAPI 3.1 για να δημιουργεί αυτόματα τους πελάτες σας.

Εξηγείται η συμμόρφωση με το eIDAS για τους προγραμματιστές

Ο κανονισμός eIDAS ορίζει τρία επίπεδα υπογραφής: απλό (SES), προηγμένο (AES) και ειδικό (QES). Το Certyneo API επιτρέπει την επιλογή του επιπέδου ανά φάκελο μέσω ενός πεδίου `signature_level`. Η προεπιλεγμένη τιμή είναι AES (απαρκής για το 95% των περιπτώσεων B2B). Το QES είναι διαθέσιμο για πράξεις που απαιτούν αυστηρή νομική ισοδυναμία με την χειρογράφηση (μητρώα, δημόσιες συμβάσεις).

Από τεχνική άποψη, το AES απαιτεί ισχυρή ταυτοποίηση του υπογράφοντα (OTP μέσω SMS από προεπιλογή, KYC βίντεο από επιλογή) και μια χρονοδιαγεγραμμένη οδική λωρίδα ελέγχου. Το QES προσθέτει ένα ειδικό πιστοποιητικό που εκδίδεται από έναν ειδικό TSP της ΕΕ. Όλα αυτά διαχειρίζονται από το API καλείς το τελικό σημείο, εμείς φροντίζουμε για τα υπόλοιπα.

Συνιστώμενη αρχιτεκτονική ενσωμάτωσης

Το πιο κοινό πρότυπο ενσωμάτωσης ακολουθεί αυτή τη ροή:

Το backend σας καλεί το POST /v1/envelopes για να δημιουργήσει το φάκελο και λαμβάνει ένα sign_url για να το παρουσιάσει στον χρήστη.
Ανακατεύετε τον χρήστη στο sign_url ή το ενσωματώνετε σε iframe (με το branding σας μέσω του Pro plan).
Μόλις ολοκληρωθεί η υπογραφή, το Certyneo καλεί το webhook σας με το γεγονός envelope.completed.
Ενημερώνετε τη βάση δεδομένων σας και ενημερώνετε τον χρήστη (μέσα από ηλεκτρονικό ταχυδρομείο, in-app, κλπ.).

Ανεξάρτητο δωρεάν Sandbox

Το περιβάλλον sandbox είναι δωρεάν και απεριόριστο. Όλες οι λειτουργίες παραγωγής είναι διαθέσιμες, εκτός από τις υπογραφές που δεν έχουν νομική ισχύ (το PDF είναι σημαδεμένο SANDBOX).

Και αν δεν θέλετε να γράψετε κώδικα

Όλα όσα κάνει αυτό το API μπορούν επίσης να ελεγχθούν χωρίς να γράψετε ούτε μία γραμμή, από μια ροή: δημιουργία φακέλου, αποστολή του, αντίδραση σε υπογραφή, ανάκτηση του σφραγισμένου PDF και του ίχνους ελέγχου του. Η ίδια βάση, με έναν οπτικό σχεδιαστή στη θέση του πελάτη HTTP. Δείτε την ενσωμάτωση Power Automate και Microsoft 365.

Μεταναστεύστε από το DocuSign ή το Yousign

Εάν έχετε ήδη μια ενσωμάτωση DocuSign ή Yousign, η χαρτογράφηση API είναι απλή: περιτυπάκια → περιτυπάκια, παραλήπτες → παραλήπτες, status webhooks → status webhooks.

Μετακινείστε από το Adobe Acrobat Sign (παλαιότερα EchoSign, στη συνέχεια Adobe Sign); Η αντιστοίχιση είναι εξίσου άμεση — agreements → envelopes, participants → recipients, webhooks → webhooks. Σύγκριση Certyneo και Adobe Acrobat Sign →

Τιμή ενός API ηλεκτρονικής υπογραφής: πού να αγοράσετε συνδρομή;

Δεν χρειάζεστε προσφορά ή δελτίο παραγγελίας για να αγοράσετε μια συνδρομή API υπογραφής: το sandbox είναι δωρεάν και απεριόριστο, το κλειδί API δημιουργείται από το dashboard, και η πρόσβαση στο API REST παραγωγής περιλαμβάνεται ήδη από το σχέδιο Standard με 19 €/μήνα — webhooks και SDK περιλαμβάνονται, χωρίς χρεώσεις ανά υπογραφή.

Standard — 19 €/μήνα: 100 φάκελοι/μήνα, API REST + webhooks, 10 χρήστες
Business — 39 €/μήνα: 300 φάκελοι/μήνα, ομαδική αποστολή, φόρμες ιστού
Business Pro — 99 €/μήνα: 1.000 φάκελοι/μήνα, API υψηλής συχνότητας (300 req/min), απεριόριστοι χρήστες

Η εγκυρολογική ψηφιακή ψηφιακός ορθολόγος (QES) είναι ένα απόδειξη στο διάστημα: 9,90 € ανά ψηφιακή ψηφιακός ορθολόγος, διθυράμβιο σε όλους τους προγραμματισμούς, συμπεριλαμβανομένου του Δωρεάν.

Για μεγάλους όγκους ή όταν απαιτείται συμβατική δέσμευση (SLA, αποκλειστικό DPA, ετήσια χρέωση), το πρόγραμμα Enterprise συνάπτεται με την εμπορική ομάδα. Σε κάθε περίπτωση, οι τιμές είναι δημόσιες — συγκρίνετέ τις πριν δεσμευτείτε.

Επικαιροποίηση των ερωτήσεων API

Ποιο είναι το όριο μειωμένου API;

1.000 αιτήσεις ανά λεπτό ως προεπιλογή, με δυνατότητα αύξησης κατόπιν αιτήματος για χρήσεις υψηλής έντασης (εργοστάσια, πλατφόρμες πολλαπλών χρηστών). Η κεφαλίδα X-RateLimit-Remaining σε κάθε απάντηση υποδεικνύει το υπόλοιπο όριο. Σε περίπτωση υπέρβασης, το API επιστρέφει κωδικό 429 με Retry-After.

Πόσο κοστίζει το API;

Το sandbox (κλειδιά sk_test_) είναι δωρεάν και απεριόριστο. Η πρόσβαση στο API REST παραγωγής περιλαμβάνεται ήδη από το σχέδιο Standard με 19 €/μήνα (100 φάκελοι/μήνα), στη συνέχεια Business με 39 €/μήνα και Business Pro με 99 €/μήνα με αυξανόμενα όρια· η προηγμένη υπογραφή (QES) είναι ένα ξεχωριστό προϊόν, χρεωμένο ανά ενέργεια 9,90 € ανά υπογραφή. Για μεγαλύτερους όγκους ή ενισχυμένο SLA, το σχέδιο Enterprise συνδέεται με την εμπορική ομάδα.

Υπάρχει ΑΛΣ;

99.95% uptime στα σχέδια Business και Enterprise (μέγιστο χρόνο αναμονής 4 ώρες ετησίως).

Ποια είναι η ταυτότητα που χρησιμοποιείτε;

Για τις ενσωματώσεις OAuth (πολυμερείς πλατφόρμες), προσφέρουμε ένα OAuth 2.0 Client Credentials στο Enterprise plan.

Πώς να ελέγξεις την υπογραφή HMAC ενός webhook;

Κάθε webhook περιλαμβάνει μια X-Certyneo-Signature επικεφαλίδα που περιέχει ένα HMAC SHA-256 του payload, υπογεγραμμένο με το μυστικό webhook σας.

Τα SDK είναι ανοιχτού κώδικα;

Ναι. Τα SDK Node, Python και Ruby είναι στο GitHub με άδεια MIT. Μπορείτε να τα forker, να συνεισφέρετε ή απλά να τα ελέγξετε. Τα δυαδικά δημοσιεύονται στο npm, PyPI και RubyGems με το namespace @certyneo / certyneo.

Μπορώ να δοκιμάσω χωρίς να εγγραφώ;

Ναι, μέσω των διαδραστικών παραδειγμάτων της τεκμηρίωσης API: /developers/playground. Οι αιτήσεις εκεί πηγαίνουν σε μια κοινή περίπτωση sandbox, χωρίς να απαιτείται κλειδί. Για σοβαρή χρήση, δημιουργήστε έναν δωρεάν λογαριασμό προγραμματιστή (απεριόριστο sandbox).

Πόσο κοστίζει το API EchoSign (το οποίο έγινε Adobe Acrobat Sign);

Το EchoSign αγοράστηκε από την Adobe το 2011, μετονομάστηκε σε Adobe Sign και στη συνέχεια σε Adobe Acrobat Sign: το API εξακολουθεί να υπάρχει, αλλά η τιμή του δεν είναι δημόσια και διέρχεται από μια επιχειρηματική προσφορά από την εμπορική ομάδα της Adobe, συνήθως ανά τμήματα ετήσιων συναλλαγών. Αντίθετα, η Certyneo εμφανίζει τις τιμές της: η πρόσβαση API παραγωγής περιλαμβάνεται ήδη από το σχέδιο Standard με 19 €/μήνα, συνδεόμενη διαδικτυακά χωρίς προσφορά, με ένα δωρεάν απεριόριστο sandbox για αξιολόγηση του API πριν πληρώσετε.

Έτοιμοι για την ενσωμάτωση της ηλεκτρονικής υπογραφής;

Απεριόριστο δωρεάν Sandbox, πλήρης τεκμηρίωση, επίσημα SDK.

Διαβάστε τα έγγραφα Μιλώντας σε έναν προγραμματιστή του Certyneo