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

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, prüft die API nun die E-Mail-Adressen der Empfänger auf potenziell ungültige Formate. Wenn etwas unpassend aussieht, erhalten Sie in der Antwort eine Warnung.

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

Betroffene Endpunkte:

Beispielantwort:

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

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

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

Die Validierung erfasst häufige Probleme wie ungewöhnliche TLDs, fehlende Punkte und offensichtliche Tippfehler. Sie blockiert keine legitimen Grenzfälle, markiert jedoch diejenigen, die am wahrscheinlichsten unzustellbar sind.

Warum das wichtig ist

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

Mit E-Mail-Validierungswarnungen können Sie diese Probleme Ihren Nutzern 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ötige Rückfragen.

Leitfaden zur Migration

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 einfach in den Antworten, sofern zutreffend.

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

Erste Schritte

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

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

Kostenlos starten

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