Was wir im Januar 2026 versendet haben

Der Januar war ein ereignisreicher Monat. Wir haben eine Reihe von Updates für Firma.dev herausgebracht, worüber wir uns sehr freuen. Die meisten davon basieren direkt auf dem Feedback, das wir von Entwicklern erhalten haben, die mit der API arbeiten.

Das Thema in diesem Monat war, die API schneller, flexibler und einfacher zu integrieren. Einige dieser Änderungen sind kleine Verbesserungen zur Steigerung der Benutzerfreundlichkeit. Andere ermöglichen völlig neue Workflows. Wir befinden uns jetzt auf Version 1.2.0, und alle Neuerungen sind ab heute live verfügbar.

Hier ist die Zusammenfassung.

40 % schnellere Signaturanfragen

Wir haben uns ein paar Wochen lang intensiv mit der Performance beschäftigt und konnten unsere durchschnittliche Latenzzeit bei Signaturanfragen von 820 ms auf etwa 500 ms senken. Das entspricht einer Verbesserung von rund 40 % auf breiter Front.

Bei den Änderungen handelte es sich größtenteils um Infrastrukturarbeiten. Wir haben einige Datenbankabfragen bereinigt, die im Laufe der Zeit ineffizient geworden waren, und wir haben statische Assets für das Edge-Caching hinter AWS CloudFront verschoben. Nichts Bahnbrechendes, aber die Art von Arbeit, die sich auszahlt.

Wenn Sie Signaturen in Ihr Produkt einbetten, ist dies wichtiger, als es zunächst scheinen mag. Eine Latenz von 300 ms klingt nicht nach viel, ist aber der Unterschied zwischen einem Signaturprozess, der sich sofort anfühlt, und einem, der träge wirkt. Schnellere Antworten bedeuten weniger abgebrochene Prozesse und weniger Reibungsverlust für Ihre Nutzer.

Einmalige Signaturanfragen (Keine Vorlage erforderlich)

Bisher mussten Sie, wenn Sie ein Dokument zur Signatur über Firma.dev senden wollten, zuerst eine Vorlage erstellen. Das war bei wiederkehrenden Workflows wie Arbeitsverträgen oder Geheimhaltungsvereinbarungen sinnvoll, bedeutete aber bei einmaligen Dokumenten unnötige Schritte.

Jetzt können Sie die Vorlage komplett überspringen. Laden Sie eine PDF-Datei direkt hoch, definieren Sie Ihre Felder und Empfänger direkt im Dokument und senden Sie es ab. Ein API-Aufruf, keine Vorlagenerstellung erforderlich.

Dies ist nützlich für Ad-hoc-Vereinbarungen, einmalige Verträge oder jede Situation, in der Sie die Dokumentenstruktur nicht wiederverwenden werden. Sie erhalten weiterhin dieselben Feldtypen, Unterzeichneroptionen und Tracking-Möglichkeiten. Sie müssen nur nicht erst eine Vorlage einrichten.

Weitere Details zur Implementierung finden Sie unter dem Endpunkt zum Erstellen von Signaturanfragen.

Atomarer Endpunkt für Erstellen + Senden

Apropos Reduzierung von API-Aufrufen: Wir haben einen neuen atomaren Endpunkt hinzugefügt, mit dem Sie eine Signaturanfrage in einem einzigen Aufruf erstellen und versenden können.

Zuvor haben Sie den Erstellungs-Endpunkt aufgerufen und anschließend den Sende-Endpunkt ausgeführt. Zwei Anfragen, zwei Roundtrips. Der neue Endpunkt /signing-requests/create-and-send kombiniert beides in einem.

Der eigentliche Vorteil ist jedoch die Transaktionsintegrität. Der Endpunkt validiert alles, bevor er irgendetwas erstellt. Wenn die Validierung fehlschlägt, wird nichts erstellt und Ihnen wird nichts in Rechnung gestellt. Credits werden erst abgezogen, nachdem die Signaturanfrage erfolgreich erstellt und die E-Mails versendet wurden.

Aus der Dokumentation: „Ein einziger API-Aufruf statt zwei separater Anfragen... Atomarer Credit-Abzug – eine Belastung erfolgt nur, wenn alles erfolgreich ist.“

Wenn Sie Automatisierungen oder Workflows mit hohem Volumen erstellen, ist dieser Endpunkt sauberer und zuverlässiger, als zwei Aufrufe aneinanderzuketten.

Schreibgeschützte Felder

Sie können Felder jetzt beim Erstellen oder Aktualisieren einer Signaturanfrage als schreibgeschützt markieren. Dies sind Felder, die auf dem Dokument mit vorausgefüllten Werten erscheinen, die der Unterzeichner jedoch nicht bearbeiten kann.

Dies ist nützlich für Dinge wie Vertragsbeträge, Referenznummern, berechnete Summen oder Mitarbeiter-IDs. Alles, was der Unterzeichner zur Information sehen muss, aber nicht ändern können sollte.

Sie finden die Eigenschaft read_only im umfassenden Aktualisierungs-Endpunkt. Setzen Sie sie bei einem beliebigen Textfeld auf true, und es wird sichtbar, aber nicht editierbar.

Granulare E-Mail-Steuerung

Wir haben vier neue Einstellungen hinzugefügt, mit denen Sie genau steuern können, welche E-Mails Firma.dev in Ihrem Namen versendet:

• send_signing_email – die erste Benachrichtigung „Bitte unterzeichnen Sie dieses Dokument“

• send_finish_email – die Bestätigung „Unterzeichnung abgeschlossen“

• send_expiration_email – die Erinnerung, wenn eine Anfrage kurz vor dem Ablauf steht

• send_cancellation_email – die Benachrichtigung, wenn eine Anfrage storniert wird

Alle vier sind standardmäßig auf true eingestellt, sodass bestehende Integrationen genau wie bisher funktionieren. Wenn Sie jedoch Ihre eigenen gebrandeten E-Mails anstelle unserer versenden möchten, können Sie nun einige oder alle dieser Optionen deaktivieren und die Benachrichtigungen selbst übernehmen.

Dies lässt sich hervorragend mit den unten stehenden White-Label-Einstellungen kombinieren.

Nutzungsbedingungen von Firma.dev überspringen für vollständiges White-Labeling

Es gibt eine neue Einstellung in Ihrem Workspace namens „Zustimmung zu den Nutzungsbedingungen anfordern“. Wenn diese aktiviert ist (Standardeinstellung), müssen Unterzeichner den Nutzungsbedingungen von Firma.dev zustimmen, bevor sie unterzeichnen können. Wenn Sie diese Option deaktivieren, fällt dieser Schritt komplett weg.

Dies ist für Teams gedacht, die ein vollständig gebrandetes (White-Label) Unterzeichnungserlebnis wünschen. Ihre Unterzeichner sehen Ihr Branding, Ihre E-Mails (wenn Sie unsere ausgeschaltet haben) und Ihre Bedingungen. Firma.dev bleibt unsichtbar.

Wenn Sie diesen Weg wählen, empfehlen wir Ihnen, eigene Nutzungsbedingungen bereitzuhalten. Sie übernehmen damit die Verantwortung, die Unterzeichner über die rechtlichen Auswirkungen ihrer Unterschrift zu informieren. Stellen Sie also sicher, dass Ihre eigenen AGBs dies abdecken.

In Kombination mit der oben genannten E-Mail-Steuerung können Sie nun ein komplett gebrandetes Unterzeichnungserlebnis anbieten, ohne dass für Ihre Endnutzer eine Benutzeroberfläche von Firma.dev sichtbar wird.

Neue Entwickler-Anleitungen

Wir haben in diesem Monat einen großen Teil unserer Dokumentation neu geschrieben. Drei neue Anleitungen sind live gegangen:

Authentifizierungs-Anleitung – Behandelt die API-Key-Authentifizierung für Server-zu-Server-Anfragen sowie JWT-Token zur Einbettung von Editoren für Vorlagen und Signaturanfragen in Ihre App. Beinhaltet auch den neuen Ablauf zur API-Key-Rotation mit einer 24-stündigen Übergangsfrist.

Leitfaden zu Ratenbegrenzungen – Dokumentiert alle Stufen der Ratenbegrenzung (200 Anfragen/Min. für Lesevorgänge, 120/Min. für Schreibvorgänge usw.). Wichtiger Hinweis hierbei: Die Ratenbegrenzungen gelten pro Workspace, und Sie können unbegrenzt viele Workspaces in Ihrem Konto haben. Das bietet Ihnen praktisch eine unbegrenzte horizontale Skalierbarkeit. Wenn Sie für einen bestimmten Anwendungsfall noch höhere Limits benötigen, wenden Sie sich an den Support, und wir können diese anheben. Die Standardwerte sind jedoch bereits für ein sehr hohes Volumen ausgelegt.

Vollständige Einrichtungsanleitung – Eine komplette End-to-End-Anleitung von der Kontoerstellung bis zur eingebetteten Signatur. Behandelt Workspaces, Vorlagen, Signaturanfragen, eingebettete Editoren, Webhooks und das Credit-Management. Wenn Sie gerade erst anfangen, ist dies der richtige Ort, um zu beginnen.

Vollständige API-Versionierung

Wir haben in diesem Monat ein formelles Versionierungssystem eingeführt. Die API nutzt nun eine Header-basierte Versionierung über den Header X-API-Version, und wir befinden uns derzeit auf v1.2.0.

Die Kurzfassung: Wir verpflichten uns, Ihre Integration nicht zu beeinträchtigen. Aus der Versionierungsanleitung: „Inkompatible Änderungen werden nur bei Erhöhung der Hauptversionsnummer (Major) eingeführt... Abwärtskompatible Änderungen wie neue optionale Felder oder neue Endpunkte erfordern keine neue Version.“

Wenn wir irgendwann eine v2 veröffentlichen, wird die alte Version nicht einfach verschwinden. Sie erhalten in den Response-Headern mindestens sechs Monate vor der Einstellung Warnungen vor Veraltung (Deprecation). Die Header entsprechen RFC 8594. Wenn Sie also bereits in anderen APIs nach Deprecation- und Sunset-Headern suchen, wissen Sie, was Sie zu erwarten haben.

Derzeit ist v1 aktiv und es ist keine Einstellung geplant. Alles, was wir in diesem Monat ausgeliefert haben, ist additiv, sodass Ihre bestehende Integration unverändert weiterfunktioniert.

Fazit

Das war der Januar. Viele kleine bis mittlere Verbesserungen, die sich zu einer leistungsfähigeren und flexibleren API summieren.

Die Preise haben sich nicht geändert. Es sind immer noch €0,049 pro Umschlag, nutzungsbasiert, ohne Mindestumsatz. Wenn Sie Firma.dev noch nicht ausprobiert haben, können Sie kostenlos und ohne Einschränkungen mit echten Dokumenten testen und zahlen erst, wenn Sie live gehen.

Wir werden auch weiterhin neue Versionen herausbringen. Wenn es etwas gibt, das Sie in der API sehen möchten, lassen Sie es uns wissen.

Kostenlos starten – keine Kreditkarte erforderlich.