Versenden Sie Ihre erste E-Signatur-Flow schnell mit Firma: Ein Entwickler-Schnellstart

Sie sind Entwickler und haben bereits Ihr Firma.dev-Konto? Perfekt. Dieser Leitfaden führt Sie vom „API-Schlüssel in der Hand“ zu einem Live-eingebetteten Signaturprozess. Wir halten es schlank, konzentrieren uns auf Entscheidungen und verlinken Sie direkt zu funktionierenden Code-Schnipseln in der Dokumentation.

Suchen Sie nach dem nicht-technischen Leitfaden? Hier klicken.

Was Sie tun werden

1. Kundenisolierung mit Workspaces modellieren

2. Eine wiederverwendbare Vorlage erstellen

3. Eine Signaturanforderung senden

4. Das Signaturerlebnis einbetten oder weiterleiten

5. Alles mit Webhooks verfolgen

Die Preisgestaltung ist einfach. Es kostet €0,029 pro Umschlag, Testen mit echten Dokumenten ist kostenlos, sodass Sie alles von Anfang bis Ende erstellen und testen können.

Voraussetzungen

Unternehmens- oder Workspace-API-Schlüssel aus Ihrem Dashboard

• Ein PDF, das Sie in eine Vorlage umwandeln können

• Ein Ort, an dem Servercode für die JWT-Generierung und Webhooks ausgeführt werden kann

Benötigen Sie eine Auffrischung des gesamten Ablaufs? Siehe den vollständigen Einrichtungsleitfaden.

1) Erstellen Sie einen Workspace für jeden Kunden

Workspaces bieten jedem Kunden einen privaten, partitionierten Bereich mit isolierten Vorlagen, Dokumenten und Nutzung. Dies ist der sauberste Weg, um eine saubere Trennung im SaaS-Stil für mehrere Mandanten aufzubauen, ohne dass Daten zwischen Kunden verloren gehen.

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Hilfreich: Workspace-Einstellungen wie E-Mail-Inhalte und Zeitzone gelten pro Workspace.

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

2) Erstellen Sie eine wiederverwendbare Vorlage

Vorlagen enthalten das PDF sowie Rollen und Felder, sodass Sie dasselbe Dokument mehrfach an verschiedene Empfänger senden können.

Create Template (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Create Template (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Create Template (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Option A: Lassen Sie Benutzer Vorlagen in Ihrer App entwerfen

Betten Sie den Vorlagen-Editor mit einem kurzlebigen JWT ein.

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Generieren Sie den Token serverseitig.

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Erstellen Sie die Signaturanforderung

Verwandeln Sie Ihre Vorlage in eine Live-Transaktion. Sie können sie auch aus einer einfachen PDF-Datei erstellen, wenn Sie dies bevorzugen. Die Referenz umfasst Empfänger, Felder, Erinnerungen und Validierungsregeln.

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Optional: Lassen Sie geschäftliche Nutzer Details ausfüllen und über Ihre Benutzeroberfläche senden

Betten Sie den Editor für Signaturanforderungen mit einem 7-Tage-JWT ein.

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Generieren Sie das JWT serverseitig.

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Senden Sie die Signaturanforderung

Wenn Sie bereit sind, lösen Sie den Sendevorgang aus.

Send signing request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Send signing request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Send signing request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Signatur in Ihrem Produkt bereitstellen oder per Weiterleitung

Eingebettete Signatur

Jeder Empfänger unterschreibt auf einer eindeutigen URL, die folgendem Muster folgt:

https://app.firma.dev/signing/{signing_request_user_id}.

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Sie rufen die signing_request_user_id von der API ab.

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Weiterleitung der Signatur

Alternativ können Sie Empfänger an die gehostete Signaturoberfläche senden. Weitere Informationen finden Sie im selben Leitfaden oben.

6) Alles mit Webhooks verfolgen

Hören Sie auf Ereignisse wie erstellt, gesendet, angesehen, signiert und abgeschlossen, um Ihr System in Echtzeit zu aktualisieren. Der Leitfaden enthält die HMAC-Überprüfung, Rotation, Wiederholungsversuche und eine Checkliste für die Produktion.

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

Webhooks guide
https://docs.firma.dev/guides/webhooks

Create webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Create webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Create webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Kurze Hinweise zur Architektur

• JWTs. Generieren Sie diese serverseitig. Token für den Vorlagen-Editor sind kurzlebig; Token für den Editor für Signaturanforderungen laufen nach 7 Tagen ab.

• Workspaces für SaaS. Halten Sie Kunden vollständig getrennt. Ihre Administratoren arbeiten dennoch von einer einzigen API aus.

• Preise und Einführung. Beginnen Sie mit den enthaltenen kostenlosen Umschlägen und gehen Sie dann live. Keine Mindestmengen. €0,029 pro Umschlag.

Wie geht es weiter?

1. Richten Sie Ihren ersten Workspace ein

2. Fügen Sie eine Vorlage hinzu

3. Senden Sie Ihre erste Anforderung

4. Wählen Sie Einbettung oder Weiterleitung

5. Verbinden Sie die Webhooks

👉 API-Schlüssel holen - keine Kreditkarte erforderlich.