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

Sind Sie Entwickler und haben bereits Ihr Firma Konto? Perfekt. Diese Anleitung bringt Sie von „API-Schlüssel in der Hand“ zu einem live eingebetteten Signaturfluss. Wir halten es schlank, konzentrieren uns auf Entscheidungen und verlinken Sie direkt zu funktionierenden Codeausschnitten in den Dokumentationen.

Suchen Sie nach dem nicht-technischen Leitfaden? Klicken Sie hier.

Was Sie tun werden

1. Kundenisolation mit Arbeitsbereichen modellieren

2. Eine wiederverwendbare Vorlage erstellen

3. Eine Signaturanfrage senden

4. Das Signaturerlebnis einbetten oder umleiten

5. Alles mit Webhooks verfolgen

Die Preisgestaltung ist einfach. Es sind $0,029 pro Umschlag, mit den ersten 25 Umschlägen kostenlos, damit Sie von Anfang bis Ende bauen und testen können.

Voraussetzungen

Firmen- oder Arbeitsbereichs-API-Schlüssel aus Ihrem Dashboard

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

• Einen Ort zum Ausführen von Servercode für JWT-Erstellung und Webhooks

Benötigen Sie eine Auffrischung über den gesamten Ablauf? Sehen Sie sich den vollständigen Einrichtungsleitfaden an.

1) Einen Arbeitsbereich für jeden Kunden erstellen

Arbeitsbereiche bieten jedem Kunden einen privaten, isolierten Raum mit getrennten Vorlagen, Dokumenten und Nutzung. Es ist der sauberste Weg, um eine SaaS-ähnliche mandantenfähige Trennung zu erstellen, ohne dass Daten zwischen Kunden durchsickern.

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: Arbeitsbereichseinstellungen wie E-Mail-Kopie und Zeitzone sind pro Arbeitsbereich.

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) Eine wiederverwendbare Vorlage erstellen

Vorlagen enthalten das PDF sowie Rollen und Felder, sodass Sie dasselbe Dokument viele Male mit unterschiedlichen Empfängern 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

Den Vorlagen-Editor mit einem kurzfristigen JWT einbetten.

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 das 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) Die Signaturanfrage erstellen

Verwandeln Sie Ihre Vorlage in eine Live-Transaktion. Sie können auch aus einem Roh-PDF erstellen, wenn Sie es bevorzugen. Der Bezug deckt Empfänger, Felder, Erinnerungen und Validierungsregeln ab.

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: Geschäftsanwender Details ausfüllen und aus Ihrer Benutzeroberfläche senden lassen

Den Signaturanfrage-Editor mit einem 7‑Tage-JWT einbetten.

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) Die Signaturanfrage senden

Wenn Sie bereit sind, lösen Sie das Senden 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) Signierung innerhalb Ihres Produkts oder per Redirect bereitstellen

Eingebettete Signierung

Jeder Empfänger unterschreibt an einer eindeutigen URL, die diesem 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 holen die signing_request_user_id aus der API.

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

Redirect Signierung

Alternativ können Sie die Empfänger zur gehosteten Signierungsoberfläche senden. Siehe oben denselben Leitfaden für Details.

6) Alles mit Webhooks verfolgen

Auf Ereignisse wie erstellt, gesendet, angesehen, unterschrieben und abgeschlossen hören, um Ihr System in Echtzeit zu aktualisieren. Der Leitfaden beinhaltet HMAC-Verifikation, Rotation, Wiederholungen und eine Produktionscheckliste.

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

Schnelle Anmerkungen zur Architektur

• JWTs. Serverseitig generieren. Vorlagen-Editor-Token sind kurzlebig; Signaturanfrage-Editor-Token laufen nach 7 Tagen ab.

• Arbeitsbereiche für SaaS. Kunden vollständig partitioniert halten. Ihre Betreiber arbeiten dennoch von einer einzigen API.

• Preisgestaltung und Einführung. Auf den enthaltenen kostenlosen Umschlägen starten und dann live gehen. Keine Mindestbeträge. $0,029 pro Umschlag.

Was kommt als nächstes?

1. Ihren ersten Arbeitsbereich einrichten

2. Eine Vorlage hinzufügen

3. Ihre erste Anfrage senden

4. Einbetten oder umleiten wählen

5. Webhooks verkabeln

👉 Holen Sie sich jetzt Ihren API-Schlüssel - keine Kreditkarte erforderlich.