Firma.dev API v1.5.0: E-Mail-Überprüfungswarnungen

Firma.dev API v1.5.0 ist jetzt live. Diese Patch-Veröffentlichung führt E-Mail-Bestätigungswarnungen ein, eine kleine Ergänzung, die hilft, schlechte E-Mail-Adressen zu erkennen, bevor sie Zustellungsfehler verursachen.

Was ist neu?

Wenn Sie eine Signaturanfrage erstellen oder aktualisieren, überprüft die API jetzt die Empfänger-E-Mail-Adressen auf potenziell ungültige Formate. Wenn etwas nicht stimmt, erhalten Sie eine Warnung in der Antwort.

Der Antrag bleibt erfolgreich. Sie erhalten lediglich einen Hinweis.

Betroffene Endpunkte:

Beispielantwort:

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Recipient email 'user@compny' may have an invalid format"
  ]
}

Die Validierung erkennt häufige Probleme wie ungewöhnliche TLDs, fehlende Punkte und offensichtliche Tippfehler. Es blockiert keine legitimen Randfälle, wird aber die wahrscheinlich zum Scheitern verurteilten kennzeichnen.

Warum das wichtig ist

E-Mail-Tippfehler sind einer der häufigsten Gründe, warum Signaturanfragen die Empfänger nicht erreichen. Ein fehlender Buchstabe, eine vertauschte Domain, ein Kopierfehler. Das Dokument wird versendet, nichts passiert, und jemand eröffnet ein Support-Ticket und fragt, warum sein Kunde es nie erhalten hat.

Mit E-Mail-Bestätigungswarnungen können Sie diese Probleme an Ihre Benutzer weitergeben, bevor die Anfrage gesendet wird. Zeigen Sie die Warnung in Ihrer Benutzeroberfläche an, fordern Sie die Benutzer auf, die Angaben zu überprüfen, und vermeiden Sie Hin und Her.

Migrationsleitfaden

Keine breaking changes. E-Mail-Bestätigungswarnungen sind rein additiv. Wenn Sie bereits mit Firma.dev integriert sind, funktioniert Ihr Code genau wie zuvor. Das warnings-Feld erscheint einfach in den Antworten, wenn zutreffend.

Um die Funktion zu nutzen, überprüfen Sie das warnings Array (oder das warning Feld bei PATCH) in Ihrer Antwortverarbeitung und zeigen Sie alle Nachrichten Ihren Benutzern an.

Erste Schritte

Wenn Sie Firma.dev bereits verwenden, sind Sie startklar. Die Funktion ist auf allen Signaturanfrage-Endpunkten live.

Neu bei Firma.dev? Sie können Ihren API-Schlüssel erhalten und in wenigen Minuten mit dem Aufbau beginnen. Nutzungsabhängige Preisgestaltung bei 0,029 € pro Dokument, keine Verträge oder Mindestabnahmen.

Kostenlos loslegen

Für das vollständige Änderungsprotokoll, siehe API-Dokumentation.