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 αντιδράστε σε πραγματικό χρόνο

Έξι γεγονότα (envelope.sent, viewed, signed, completed, declined, expired) με ελεγχόμενη υπογραφή 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).

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

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

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

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

Η αρχική τιμή που χρησιμοποιείται για την ανάλυση των αναγκών είναι η τιμή που πρέπει να χρησιμοποιηθεί για την ανάλυση των αναγκών.

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

Το Sandbox είναι δωρεάν και απεριόριστο. Η παραγωγή λειτουργεί με πληρωμή κατά την υπογραφή (από € 0,40 η υπογραφή AES με υποβάθμιση όγκου), χωρίς ελάχιστη συνδρομή.

Υπάρχει ΑΛΣ;

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).

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

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

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