E-Signatur-API

E-Signatur-API: Was bedeutet der Begriff?

Eine E-Signatur-API ist eine Programmierschnittstelle, über die Ihre eigene Software Dokumente zur Unterschrift versendet, ihren Status verfolgt und die unterschriebenen Dateien abruft, ohne dass jemand sich durch die Web-App des Anbieters klickt. Kurz: So automatisieren Entwickler das Unterschreiben und verbinden es mit CRM, Personalsoftware und eigenen Produkten.

Eine typische Integration sieht so aus: Ihr System authentifiziert sich mit einem API-Schlüssel, schickt eine Anfrage, um aus einem PDF oder einer Vorlage eine Signaturanfrage zu erstellen, nennt die Unterzeichner und ihre Reihenfolge und erhält eine ID zurück. Der Anbieter schickt den Unterzeichnern dann E-Mails oder liefert eine URL für die eingebettete Signatur. Ändert sich etwas, etwa durch eine Unterschrift oder eine Ablehnung, ruft der Anbieter Ihren Webhook auf, und Ihr System lädt das fertige Dokument und seinen Audit-Trail herunter.

Nehmen Sie eine Personalvermittlung, die jede Woche Freiberufler vermittelt. Statt dass eine Recruiterin jeden Vertrag von Hand hochlädt, ruft das Bewerbermanagementsystem die API auf, sobald eine Vermittlung bestätigt ist, füllt die Vorlage mit den Daten des Freiberuflers und legt die unterschriebene Fassung automatisch im Kandidatenprofil ab.

Ein Irrtum ist, eine API sei nur etwas für Großunternehmen. Auch kleine Teams mit einem einzigen wiederkehrenden Ablauf profitieren, und No-Code-Tools können eine API oft für Sie aufrufen. Ein anderer: Per API unterschriebene Dokumente seien rechtlich irgendwie anders. Es sind dieselben Signaturen mit demselben Audit-Trail, nur durch Code angestoßen.

Die API ist die Grundlage für die eingebettete Signatur und oft auch für den Massenversand, und sie baut meist auf Vorlagen auf, damit Dokumente einheitlich erzeugt werden.

Achten Sie bei jeder E-Signatur-API auf praktische Details: klare Dokumentation, eine Sandbox oder einen Testmodus, vernünftige Rate-Limits, Wiederholungsversuche bei Webhooks und die Möglichkeit, sowohl das unterschriebene PDF als auch den Audit-Trail herunterzuladen. Prüfen Sie, wie Fehler gemeldet werden und ob die API dieselben Vorlagen nutzen kann, die Ihr Team in der Web-App pflegt. Diese Details entscheiden, ob eine Integration einen Tag oder einen Monat dauert und ob sie nach dem Start still weiterläuft.

Unsere Meinung: Ist die Unterschrift ein Schritt in einem Prozess, den Ihre Software ohnehin abwickelt, spart eine API echte Stunden und verhindert Copy-and-paste-Fehler. Wenn Sie ein paar Verträge pro Woche versenden, ist die Web-App schneller eingerichtet und leichter zu pflegen.

Die REST-API von eSignSimple ist live: Authentifizierung mit einem Bearer-API-Schlüssel, Dokumente aus einem PDF oder einer Vorlage anlegen und versenden, Status und Audit-Trail verfolgen, das unterschriebene PDF herunterladen und Webhooks erhalten, wenn Dokumente abgeschlossen, abgelehnt oder storniert werden. SDKs, eine Sandbox und Embedded Signing stehen auf unserer Roadmap. Jedes abgeschlossene Dokument enthält einen Audit-Trail, ein Abschlusszertifikat und einen SHA-256-Hash, der auf unserer öffentlichen Seite prüfbar ist. Die vollständige Referenz finden Sie in unserer Entwicklerdokumentation.

E-Signatur-API: Wie sieht das in der Praxis aus?

Ein kleines SaaS-Unternehmen möchte, dass jeder neue Enterprise-Kunde automatisch ein Bestellformular unterschreibt. Wird ein Deal im CRM als gewonnen markiert, ruft ein Skript die REST-API von eSignSimple mit einem API-Schlüssel auf, erstellt aus der Bestellformular-Vorlage ein Dokument mit den Kundendaten und versendet es. Ein Webhook meldet dem System, wenn das Dokument abgeschlossen ist, und das Skript lädt das unterschriebene PDF in den Kundendatensatz.

Welche Begriffe hängen damit zusammen?

• Vorlage: Eine E-Signatur-Vorlage ist ein wiederverwendbares Dokument mit festgelegten Unterzeichnerrollen und Feldern, damit Sie denselben Vertrag immer wieder senden können, ohne ihn neu einzurichten.
• Massenversand: Mit dem Massenversand schicken Sie ein Dokument oder eine Vorlage auf einmal an viele Empfänger, wobei jede Person ihre eigene Kopie erhält und unterschreibt.
• Webformular (Signaturlink): Ein Webformular ist beim elektronischen Unterschreiben eine gehostete Seite zum Ausfüllen und Unterschreiben mit öffentlichem Link, über die jeder ohne vorherige Einladung ein Dokument unterschreiben kann.
• Eingebettete Signatur (Embedded Signing): Bei der eingebetteten Signatur unterschreiben Personen Dokumente direkt in Ihrer eigenen Website oder App, statt einem E-Mail-Link zur Seite des E-Signatur-Anbieters zu folgen.