Was wir im Januar 2026 versendet haben

Der Januar war ein arbeitsreicher Monat. Wir haben eine Reihe von Updates für Firma.dev veröffentlicht, über die wir uns sehr freuen, und die meisten kamen direkt aus dem Feedback von Entwicklern, die auf der API aufbauen.

Das Thema in diesem Monat war, die API schneller, flexibler und einfacher zu integrieren zu machen. Einige dieser Änderungen sind kleine Verbesserungen der Lebensqualität. Andere schalten völlig neue Workflows frei. Wir sind jetzt bei Version 1.2.0 und alles hier ist heute live.

Hier ist die Übersicht.

40% schnellere Signaturanfragen

Wir haben ein paar Wochen damit verbracht, die Leistung zu untersuchen und es geschafft, die durchschnittliche Latenzzeit für Signaturanfragen von 820 ms auf etwa 500 ms zu reduzieren. Das ist eine Verbesserung von etwa 40% insgesamt.

Die Änderungen waren hauptsächlich Infrastrukturarbeiten. Wir haben einige Datenbankabfragen bereinigt, die im Laufe der Zeit ineffizient geworden waren, und statische Assets hinter AWS CloudFront für das Edge-Caching verschoben. Nichts bahnbrechendes, aber die Art von Arbeit, die sich aufsummiert.

Wenn Sie Unterschriften in Ihr Produkt einbetten, ist dies wichtiger als es scheint. 300 ms Latenz klingen nicht nach viel, aber es ist der Unterschied zwischen einem Signaturprozess, der sich sofort anfühlt, und einem, der sich träge anfühlt. Schnellere Antworten bedeuten weniger abgebrochene Abläufe und weniger Reibung für Ihre Benutzer.

Einmalige Signaturanfragen (keine Vorlage erforderlich)

Bisher mussten Sie, wenn Sie ein Dokument über Firma.dev zur Unterschrift senden wollten, zuerst eine Vorlage erstellen. Das machte Sinn für wiederholbare Workflows wie Arbeitsverträge oder NDAs, fügte jedoch unnötige Schritte für einmalige Dokumente hinzu.

Jetzt können Sie die Vorlage vollständig überspringen. Laden Sie ein PDF direkt hoch, definieren Sie Ihre Felder und Empfänger inline und senden Sie es aus. 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 Dokumentstruktur nicht wiederverwenden werden. Sie erhalten dennoch alle dieselben Feldtypen, Unterzeichneroptionen und Tracking. Sie müssen nur nicht zuerst eine Vorlage einrichten.

Sehen Sie sich den Erstellungsendpunkt für Signaturanfragen für Implementierungsdetails an.

Atomarer Erstellungs- + Sende-Endpunkt

Und apropos Reduzierung von API-Aufrufen: wir haben einen neuen atomaren Endpunkt hinzugefügt, der es Ihnen ermöglicht, eine Signaturanfrage in einem einzigen Aufruf zu erstellen und zu senden.

Bisher mussten Sie den Erstellungsendpunkt aufrufen und dann den Sendeendpunkt aufrufen. Zwei Anfragen, zwei Roundtrips. Der neue /signing-requests/create-and-send Endpunkt kombiniert beide in einem.

Aber der wirkliche Vorteil ist die transaktionale Integrität. Der Endpunkt validiert alles, bevor er etwas erstellt. Wenn etwas die Validierung nicht besteht, wird nichts erstellt und Ihnen wird nichts berechnet. Guthaben werden erst abgezogen, nachdem die Signaturanfrage erfolgreich erstellt wurde und die E-Mails verschickt wurden.

Aus den Docs: "Einzelner API-Aufruf anstelle von zwei separaten Anfragen... Atomarer Guthabenabzug – nur Belastung, wenn alles erfolgreich ist."

Wenn Sie Automatisierungen oder hochvolumige Workflows erstellen, ist dieser Endpunkt sauberer und zuverlässiger als das Verketten von zwei Aufrufen.

Schreibgeschützte Felder

Sie können jetzt Felder als schreibgeschützt markieren, wenn Sie eine Signaturanfrage erstellen oder aktualisieren. Dies sind Felder, die mit vorausgefüllten Werten auf dem Dokument angezeigt werden, aber der Unterzeichner kann sie nicht bearbeiten.

Dies ist nützlich für Dinge wie Vertragsbeträge, Referenznummern, berechnete Gesamtsummen oder Mitarbeiter-IDs. Alles, was der Unterzeichner aus Kontextgründen sehen, aber nicht ändern sollte.

Sie finden die read_only Eigenschaft im umfassenden Aktualisierungsendpunkt. Setzen Sie sie auf true auf jedem Textfeld, und es wird sichtbar, aber nicht bearbeitbar.

Granulare E-Mail-Steuerung

Wir haben vier neue Einstellungen hinzugefügt, die Ihnen eine fein abgestimmte Kontrolle darüber geben, welche E-Mails Firma.dev in Ihrem Namen versendet:

• send_signing_email – die initiale "Bitte signieren Sie dieses Dokument" Benachrichtigung

• send_finish_email – die "Signatur abgeschlossen" Bestätigung

• send_expiration_email – die Erinnerung, wenn eine Anfrage bald abläuft

• send_cancellation_email – die Benachrichtigung, wenn eine Anfrage abgebrochen wird

Alle vier sind standardmäßig auf true gesetzt, sodass bestehende Integrationen genau wie zuvor funktionieren. Aber wenn Sie stattdessen Ihre eigenen gebrandeten E-Mails versenden möchten, können Sie jetzt jede oder alle dieser ausschalten und die Benachrichtigungen selbst verwalten.

Dies passt gut zu den untenstehenden White-Label-Einstellungen.

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

Es gibt eine neue Einstellung in Ihrem Arbeitsbereich namens "Erfordern Sie das Akzeptieren der Bedingungen." Wenn sie aktiviert ist (Standard), müssen die Unterzeichner die Bedingungen und Konditionen von Firma.dev akzeptieren, bevor sie unterschreiben. Wenn Sie sie deaktivieren, entfällt dieser Schritt vollständig.

Dies ist für Teams gedacht, die eine vollständig gebrandete Signaturerfahrung wünschen. Ihre Unterzeichner sehen Ihr Branding, Ihre E-Mails (wenn Sie unsere deaktiviert haben) und Ihre Bedingungen. Firma.dev bleibt unsichtbar.

Wenn Sie diesen Weg gehen, empfehlen wir, eigene Bedingungen und Konditionen zu haben. Sie übernehmen die Verantwortung für die Information der Unterzeichner über die rechtlichen Auswirkungen ihrer Unterschrift, stellen Sie also sicher, dass Ihre eigenen AGBs dies abdecken.

Kombiniert mit den obigen E-Mail-Steuerungen können Sie jetzt eine vollständig gebrandete Signaturerfahrung ohne jegliche Firma.dev-Benutzeroberfläche für Ihre Endbenutzer führen.

Neue Entwickleranleitungen

Wir haben einen Teil unserer Dokumentation in diesem Monat neu geschrieben. Drei neue Leitfäden sind live gegangen:

Authentifizierungsleitfaden – Behandelt die API-Schlüsselauthentifizierung für Server-zu-Server-Anfragen sowie JWT-Token zum Einbinden der Vorlagen- und Signaturanfrage-Editoren in Ihre App. Enthält auch den neuen API-Schlüsselrotationsablauf mit 24-Stunden-Toleranz.

Rate Limit Leitfaden – Dokumentiert alle Rate Limit-Stufen (200 Anfragen/Min für Lesevorgänge, 120/Min für Schreibvorgänge usw.). Wichtiger Hinweis hier: Rate Limits sind pro Arbeitsbereich, und Sie können unbegrenzte Arbeitsbereiche in Ihrem Konto haben. Das gibt Ihnen effektiv unbegrenzte horizontale Skalierbarkeit. Wenn Sie irgendwann noch höhere Limits für einen bestimmten Anwendungsfall benötigen, wenden Sie sich an den Support und wir können sie erhöhen, aber die Standardwerte sind bereits für sehr hohe Volumen ausgelegt.

Vollständiger Setup-Leitfaden – Ein vollständiges End-to-End-Setup vom Kontoerstellung bis zum eingebetteten Signing. Behandelt Arbeitsbereiche, Vorlagen, Signaturanfragen, eingebettete Editoren, Webhooks und Kreditverwaltung. Wenn Sie gerade erst anfangen, ist dies der richtige Ort zum Starten.

Komplette API-Versionierung

Wir haben diesen Monat ein formales Versionierungssystem eingeführt. Die API verwendet jetzt eine headerbasierte Versionierung über den X-API-Version Header und wir sind derzeit bei v1.2.0.

Die Kurzversion: Wir verpflichten uns, Ihre Integration nicht zu stören. Aus dem Versionierungsleitfaden: "Breaking Changes werden nur in großen Versionsincrements eingeführt... Nicht-breaking Änderungen wie neue optionale Felder oder neue Endpunkte erfordern keine neue Version."

Wenn wir irgendwann eine v2 veröffentlichen, verschwindet die alte Version nicht einfach. Sie erhalten mindestens sechs Monate lang Deprecation-Warnungen in den Antwort-Headern, bevor etwas eingestellt wird. Die Header folgen RFC 8594, sodass Sie, wenn Sie bereits auf Deprecation und Sunset Header in anderen APIs überprüfen, wissen, was Sie erwartet.

Im Moment ist v1 aktiv ohne geplante Einstellung. Alles, was wir diesen Monat veröffentlicht haben, ist additive, sodass Ihre bestehende Integration weiterhin ohne Änderungen funktioniert.

Zusammenfassung

Das war der Januar. Viele kleine bis mittlere Verbesserungen, die zu einer fähigeren, flexibleren API führen.

Preise haben sich nicht geändert. Es kostet weiterhin $0.029 pro Umschlag, Pay-as-you-go, keine Mindestbeträge. Wenn Sie Firma.dev noch nicht ausprobiert haben, erhalten Sie 25 kostenlose Umschläge zum Testen.

Wir werden weiterhin veröffentlichen. Wenn es etwas gibt, das Sie in der API sehen möchten, lassen Sie es uns wissen.

Jetzt kostenlos beginnen – keine Kreditkarte erforderlich.