Simplifi Platform API · für Entwickler
Einfache oder qualifizierte E-Signaturen,
aus Ihrem Code.
Ein einziger Aufruf sendet das Dokument und liefert pro Unterzeichner einen Signatur-Link zurück. Wie jeder Einzelne unterschreibt, entscheiden Sie pro Unterzeichner: einfache Signatur, sofort ausgestelltes qualifiziertes eIDAS-Zertifikat oder das eigene Zertifikat des Nutzers. Erstellen Sie Ihre Zugangsdaten in der App und machen Sie Ihren ersten Aufruf in wenigen Minuten.
Die technische Dokumentation ist auf Englisch.
# 1. Get an access token (OAuth2 client_credentials)
curl -X POST https://auth.simplifi.ro/realms/Simplifi/protocol/openid-connect/token \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_SECRET"
# 2. Send your first document: one call, a signing link per signer
curl -X POST https://api.simplifi.ro/publicapi/v1/send-document \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "signers": [ { "email": "ana@example.com", "name": "Ana Popescu" } ],
"documents": [ { "name": "First contract", "pdf_base64": "<base64 PDF>" } ] }'
Keine API-Gebühr. Kein Genehmigungsprozess.
Die API ist für jedes Simplifi-Unternehmenskonto aktiv. Es gibt kein separates Abonnement, keine Warteliste und kein Verkaufsgespräch.
API-Gebühr
Der API-Zugang ist in Ihrem Unternehmenskonto enthalten: keine Plattformgebühr und kein Integrationsabonnement.
Erforderliche Genehmigungen
Ein Unternehmensadministrator erstellt den API-Client in der App (API-Einstellungen) und erhält die Zugangsdaten sofort.
Gleiche Kosten wie in der App
Die API-Nutzung verbraucht dasselbe Guthaben wie die Web-App, zu denselben Preisen: Umschläge, Signaturpakete, einseitige Dokumente. Kein API-Aufschlag und keine überraschende Rechnung: Wenn Ihr Guthaben aufgebraucht ist, erhalten Sie einen stabilen insufficient_*_balance-Fehler.
Ein Aufruf zum Senden. Zwei Entscheidungen.
Sie machen einen einzigen API-Aufruf. Alles Weitere sind zwei Entscheidungen, die Sie pro Anfrage treffen: wer den Signaturprozess steuert und wie jeder Unterzeichner unterschreibt.
Der eine Aufruf
Ein Dokument senden
POST /publicapi/v1/send-document lädt das PDF hoch, benennt die Unterzeichner, platziert die Signaturfelder und sendet. Die Antwort enthält das Dokument und pro Unterzeichner eine signing_url. Status, Download und das Abschlusszertifikat kommen aus GET /documents/{uuid} und den document.*-Webhooks; mehr ist nicht nötig.
- Handelt als
- Ihr Unternehmen (Servicekonto)
- Authentifizierung
client_credentials-Access-Token- Entscheidung 1
send_email, pro Anfrage- Entscheidung 2
kind, pro Unterzeichner; frei kombinierbar in einem Dokument
POST /publicapi/v1/send-document
{
"send_email": 0,
"return_url": "https://your.app/signed",
"signers": [
{ "email": "ana@example.com", "name": "Ana Popescu", "kind": "simple" },
{ "email": "dan@example.com", "name": "Dan Ionescu", "kind": "qualified" }
],
"documents": [ { "name": "Contract", "pdf_base64": "JVBERi0x..." } ]
}
# 200
{ "data": { "document_uuid": "...",
"signers": [ { "email": "ana@...", "signing_url": "https://app.simplifi.ro/signing-guest/..." },
{ "email": "dan@...", "signing_url": "https://app.simplifi.ro/signing-guest/..." } ] } }
Entscheidung 1
Wer den Signaturprozess steuert
send_email: 1
Simplifi übernimmt alles
Simplifi schickt jedem Unterzeichner die Einladung per E-Mail, hostet die Signatur und versendet die Abschlussbenachrichtigung. Ihr Part endet mit dem Aufruf: Sie warten auf den document.completed-Webhook (oder fragen den Status ab) und laden dann das signierte PDF und das Abschlusszertifikat herunter.
- Einladung
- Simplifi sendet den Link per E-Mail, und die Abschlussbenachrichtigung
- Kanalnachweis
- der E-Mail-Link selbst
- Nach der Signatur
- die Abschlussseite von Simplifi oder Ihre
return_url - Passt, wenn
- Sie nach einem einzigen Aufruf fertig sein möchten
send_email: 0 (Standard)
Sie binden die Signatur in Ihr eigenes Produkt ein
Keine E-Mail verlässt Simplifi. Die Antwort liefert Ihnen pro Unterzeichner eine signing_url: Zeigen Sie sie als Schaltfläche in Ihrer Web- oder Mobile-App, versenden Sie sie per eigener E-Mail oder SMS. Der Unterzeichner unterschreibt auf der von Simplifi gehosteten Seite und kehrt mit einem signierten Ergebnis zu Ihrer return_url zurück, auf den Bildschirm, von dem er kam. Keine Simplifi-E-Mails, keine Aufforderung, ein Konto anzulegen.
- Einladung
- Ihre: In-App-Bildschirm, E-Mail, SMS, Push, Deep Link
- Kanalnachweis
- ein SMS-Code auf der Seite (Sie übergeben
phone) - Nach der Signatur
- Ihre
return_url, mit einem signierten Ergebnis - Passt, wenn
- der Unterzeichner den Ablauf Ihres Produkts nie verlassen soll
Entscheidung 2
Wie jeder Unterzeichner unterschreibt
Ein kind pro Unterzeichner; in einem Dokument kombinierbar. Drei Unterzeichnertypen, keine Stufen: Wählen Sie den passenden für jede Person.
kind: simple
Einfache Signatur
Jeder, ohne Konto. Der Unterzeichner öffnet den Link, akzeptiert die Bedingungen, bestätigt einen Einmalcode und unterschreibt. Simplifi bringt sein qualifiziertes Siegel im Namen des Unterzeichners an. Für Einwilligungen, Kenntnisnahmen, alltägliche Vereinbarungen.
- Der Unterzeichner braucht
- nichts
- Auf der Seite
- Bedingungen, Bestätigungscode, Signatur
- Sie erhalten
- einfache elektronische Signatur nach eIDAS (SES); Nachweise versiegelt im Abschlusszertifikat
- Sie zahlen
- einen Umschlag für einfache Signaturen pro Paket, beim Abschluss
kind: qualified
Qualifizierte Signatur, Einmalzertifikat
Jeder, ohne Konto. Dieselbe Seite, plus Identitätsprüfung: Ausweisdokument und ein Selfie mit Lebenderkennung. Ein nur für diese Signatur ausgestelltes qualifiziertes Zertifikat signiert das Dokument. Für Verträge mit jemandem, den Sie nicht unbedingt wiedersehen.
- Der Unterzeichner braucht
- ein Ausweisdokument
- Auf der Seite
- Bedingungen, Code, Identitätsprüfung, Signatur
- Sie erhalten
- qualifizierte elektronische Signatur nach eIDAS (QES), der handschriftlichen gleichgestellt; die Identitätsdaten bleiben bei Simplifi
- Sie zahlen
- einen vorausbezahlten Umschlag pro Unterzeichner, beim Senden
kind: account
Qualifizierte Signatur, Langzeitzertifikat: das Ihrer Nutzer
Personen, die Sie einmal onboardet haben (Partner-Onboarding), besitzen ein qualifiziertes Zertifikat auf ihrem eigenen Simplifi-Konto. Zwei Wege zu unterschreiben: Sie öffnen den Link und melden sich an, bestätigt über ihre Authenticator-App; oder, sobald sie Ihre Anwendung autorisiert haben (OAuth auf Ihrem API-Client), führt Ihre Software den Signaturschritt über die API aus, autorisiert durch ihren Authenticator-Code. Dieselbe Einwilligung erlaubt Ihrer Software, für sie zu handeln: Dokumente, Posteingang, Aufbewahrung.
- Der Unterzeichner braucht
- sein Simplifi-Konto und Zertifikat
- Identitätsprüfung
- einmalig, beim Onboarding; nie wiederholt
- Sie erhalten
- qualifizierte elektronische Signatur nach eIDAS (QES) mit dem eigenen Zertifikat der Person
- Sie zahlen
- eine gesponserte Signatureinladung pro Dokument, beim Senden
Integration elektronischer Signaturen, für jede Plattform
Die Simplifi eIDAS API deckt die Signatur-Workflows von Anwendungen ab, die mit Dokumenten arbeiten:
HR & Recruiting
Arbeitsverträge, Nachträge und Personalakten, beim Onboarding unterschrieben.
ERP & Buchhaltung
Lieferantenverträge und steuerliche Dokumente, direkt aus dem bestehenden System unterschrieben.
Immobilien
Vorverträge, Mietverträge und Übergabeprotokolle, aus der Ferne unterschrieben.
Fintech & Versicherungen
Kunden-Onboarding, Policen und Kreditverträge mit voller Rechtsgültigkeit.
Gesundheitswesen
Patienteneinwilligungen und medizinische Dokumente, qualifiziert signiert.
Marketplace & SaaS
Jede Plattform, die gegengezeichnete Dokumente zwischen ihren Nutzern benötigt.
Für die Integration gebaut
eIDAS-qualifiziert, von einem QTSP
Qualifizierte Signaturen mit derselben Rechtsgültigkeit wie handschriftliche Unterschriften in der gesamten EU, ausgestellt von einem beaufsichtigten qualifizierten Vertrauensdiensteanbieter.
OAuth2 + REST
Standard-OAuth2-Authentifizierung, JSON rein, JSON raus, keine verpflichtenden proprietären SDKs.
Signierte Webhooks
document.signer.signed, document.completed, document.rejected, plus Guthabenwarnungen. Jede Zustellung ist mit HMAC-SHA256 signiert.
OpenAPI-3.1-Spezifikation
Die vollständige API-Spezifikation ist öffentlich: Generieren Sie Clients und Tests direkt daraus.
Postman-Collection
Eine personalisierte Postman-Umgebung und Codebeispiele im Entwicklerportal in der App.
Testumgebung
Testen Sie Ihre Integration End-to-End in der Entwicklungsumgebung (app.dev.simplifi.ro), bevor Sie in Produktion gehen.
OpenAPI-3.1-Spezifikation herunterladenPostman-Collection öffnenCodebeispiele auf GitHub
Häufige Fragen zur API
Kann ich das Signieren direkt in meine Plattform integrieren, ohne dass der Unterzeichner sie verlässt?
Ja. Senden Sie das Dokument mit send_email: 0 (Standard): Keine E-Mail verlässt Simplifi, Sie erhalten pro Unterzeichner eine signing_url und zeigen sie in Ihrer eigenen App an oder versenden sie über Ihren eigenen Kanal. Der Unterzeichner unterschreibt auf der von Simplifi gehosteten Seite und kehrt mit einem signierten Ergebnis zu Ihrer return_url zurück. Für Nutzer, die Sie onboardet haben (kind: account), kann Ihre Software den Signaturschritt sogar selbst über die API ausführen, sobald der Nutzer Ihre Anwendung per OAuth autorisiert hat.
Was ist der Unterschied zwischen einer einfachen und einer qualifizierten Signatur?
Eine einfache Signatur (SES) braucht weder Konto noch Identitätsprüfung: Der Unterzeichner bestätigt einen Einmalcode und unterschreibt, und Simplifi versiegelt die Nachweise im Abschlusszertifikat. Eine qualifizierte Signatur (QES) ist der handschriftlichen Unterschrift in der gesamten EU rechtlich gleichgestellt und erfordert die Prüfung der Identität des Unterzeichners, entweder sofort (Ausweisdokument und Selfie, für ein nur für diese Signatur ausgestelltes Zertifikat) oder einmalig beim Onboarding, für Nutzer mit eigenem Zertifikat. In der API wählen Sie die Stufe pro Unterzeichner über kind und können sie in einem Dokument kombinieren.
Was kostet die Nutzung der API?
Die API-Nutzung ist Teil Ihres regulären Abonnements: dasselbe Guthaben und dieselben Preise wie in der Web-App, unabhängig vom Unterzeichnertyp. Eine einfache Signatur verbraucht einen Umschlag für einfache Signaturen pro Paket, beim Abschluss; ein qualifiziertes Einmalzertifikat einen vorausbezahlten Umschlag pro Unterzeichner, beim Senden; ein Unterzeichner mit eigenem Konto eine gesponserte Signatureinladung pro Dokument, beim Senden. Es gibt keine API-Gebühr, kein separates Abonnement und keinen API-Aufschlag. Wenn Ihr Guthaben aufgebraucht ist, gibt die API einen stabilen insufficient_*_balance-Fehler zurück, den Sie in Ihrer Anwendung behandeln können.
Brauche ich eine Genehmigung, um zu starten?
Nein. Ein Unternehmensadministrator erstellt den API-Client in der App unter API-Einstellungen und erhält die Zugangsdaten sofort. Es gibt nichts zu beantragen und niemanden, auf den Sie warten müssen.
Brauchen meine Empfänger ein Simplifi-Konto?
Nein, es sei denn, Sie entscheiden sich dafür. Mit kind: simple und kind: qualified öffnet der Unterzeichner den Link und unterschreibt ohne jedes Konto: Bei der einfachen Signatur bestätigt er einen Einmalcode, bei der qualifizierten durchläuft er zusätzlich die Identitätsprüfung (Ausweisdokument und Selfie), und ein nur für diese Signatur ausgestelltes qualifiziertes Zertifikat signiert das Dokument. Nur kind: account erfordert ein Simplifi-Konto mit eigenem qualifiziertem Zertifikat, für Nutzer, die Sie einmal per Partner-Onboarding registriert haben.
Gibt es eine Testumgebung?
Ja. Sie können Ihre Integration gegen die Entwicklungsumgebung testen: Die App läuft unter app.dev.simplifi.ro, die API und ihre Dokumentation unter api.dev.simplifi.ro. In der Produktion wird api.simplifi.ro verwendet, mit denselben APIs.
Gibt es Rate Limits?
Ja, und sie sind in der API-Dokumentation veröffentlicht: 1800 Anfragen pro Minute für Integrations-Tokens und 600 Anfragen pro Minute für Nutzer-Tokens. Großzügige Limits für typische Dokumenten-Workflows.
Machen Sie heute Ihren ersten Aufruf
Die Dokumentation ist öffentlich, die Zugangsdaten sind Self-Service und die Kosten fallen pro Nutzung an. Von null zu einem authentifizierten Aufruf in drei Schritten.
Technische Fragen? Schreiben Sie uns an easy@simplifi.ro.