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

Die Firma.dev API v1.5.0 ist jetzt live. Dieses Patch-Release führt E-Mail-Validierungswarnungen ein, eine kleine Ergänzung, die Ihnen hilft, fehlerhafte E-Mail-Adressen abzufangen, bevor sie zu Zustellungsfehlern führen.

Was ist neu

Wenn Sie eine Signaturanforderung erstellen oder aktualisieren, überprüft die API nun die E-Mail-Adressen der Empfänger auf potenziell ungültige Formate. Wenn etwas ungewöhnlich aussieht, erhalten Sie in der Antwort eine Warnung.

Die Anforderung ist weiterhin erfolgreich. Sie erhalten lediglich einen Hinweis.

Betroffene Endpunkte:

Beispielantwort:

{
  "signing_request": { ... },
  "warnings": [
    "Die Empfänger-E-Mail-Adresse 'user@compny' weist möglicherweise ein ungültiges Format auf"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Die Empfänger-E-Mail-Adresse 'user@compny' weist möglicherweise ein ungültiges Format auf"
  ]
}

{
  "signing_request": { ... },
  "warnings": [
    "Die Empfänger-E-Mail-Adresse 'user@compny' weist möglicherweise ein ungültiges Format auf"
  ]
}

Die Validierung erkennt häufige Probleme wie ungewöhnliche TLDs, fehlende Punkte und offensichtliche Tippfehler. Legitime Grenzfälle werden nicht blockiert, aber die Fälle, bei denen ein Bounce am wahrscheinlichsten ist, werden markiert.

Warum das wichtig ist

Tippfehler in E-Mail-Adressen sind einer der häufigsten Gründe, warum Signaturanforderungen die Empfänger nicht erreichen. Ein fehlender Buchstabe, eine vertauschte Domain, ein Copy-Paste-Fehler. Das Dokument wird gesendet, nichts passiert und jemand öffnet ein Support-Ticket mit der Frage, warum der Kunde es nie erhalten hat.

Mit E-Mail-Validierungswarnungen können Sie diese Probleme Ihren Benutzern anzeigen, bevor die Anforderung gesendet wird. Zeigen Sie die Warnung in Ihrer Benutzeroberfläche an, fordern Sie sie zur Überprüfung auf und vermeiden Sie unnötigen Klärungsbedarf im Nachhinein.

Migrationsleitfaden

Keine bahnbrechenden Änderungen. E-Mail-Validierungswarnungen sind rein additiv. Wenn Sie bereits in Firma.dev integriert sind, funktioniert Ihr Code weiterhin genau wie zuvor. Das Feld warnings erscheint bei Bedarf einfach in den Antworten.

Um diese Funktion zu nutzen, prüfen Sie bei Ihrer Antwortverarbeitung das warnings-Array (oder das warning-Feld bei PATCH) und zeigen Sie Ihren Benutzern entsprechende Meldungen an.

Erste Schritte

Wenn Sie Firma.dev bereits nutzen, ist alles bereit. Die Funktion ist auf allen Endpunkten für Signaturanforderungen live.

Neu bei Firma.dev? Sie können Ihren API-Schlüssel anfordern und in wenigen Minuten mit der Entwicklung beginnen. Nutzungsbasierte Preise ab 0,049 € pro Umschlag, keine Verträge oder Mindestlaufzeiten.

Kostenlos starten

Das vollständige Änderungsprotokoll finden Sie in der API-Dokumentation.