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 Warnungen zur E-Mail-Validierung ein, eine kleine Ergänzung, mit der du fehlerhafte E-Mail-Adressen erkennst, bevor sie zu Zustellfehlern führen.

Was ist neu

Wenn du eine Unterzeichnungsanfrage erstellst oder aktualisierst, prüft die API jetzt die E-Mail-Adressen der Empfänger auf potenziell ungültige Formate. Wenn etwas nicht stimmt, erhältst du eine Warnung in der Antwort.

Die Anfrage wird trotzdem erfolgreich ausgeführt. Du bekommst lediglich einen Hinweis.

Betroffene Endpunkte:

Beispielantwort:

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

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

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

Die Validierung erkennt häufige Probleme wie ungewöhnliche TLDs, fehlende Punkte und offensichtliche Tippfehler. Sie blockiert keine legitimen Sonderfälle, markiert aber die, die am ehesten nicht zugestellt werden.

Warum das wichtig ist

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

Mit Warnungen zur E-Mail-Validierung kannst du diese Probleme deinen Nutzern anzeigen, bevor die Anfrage abgeschickt wird. Zeige die Warnung in deiner UI an, bitte sie, alles noch einmal zu prüfen, und vermeide das Hin und Her.

Migrationsleitfaden

Keine Breaking Changes. Warnungen zur E-Mail-Validierung sind rein ergänzend. Wenn du bereits mit Firma.dev integriert bist, funktioniert dein Code weiterhin genau wie zuvor. Das warnings-Feld erscheint einfach in Antworten, wenn es relevant ist.

Um die Funktion zu nutzen, prüfe in deiner Antwortverarbeitung auf das warnings-Array (oder das warning-Feld bei PATCH) und zeige alle Meldungen deinen Nutzern an.

Loslegen

Wenn du Firma.dev bereits verwendest, bist du startklar. Die Funktion ist auf allen Endpunkten für Unterzeichnungsanfragen live.

Neu bei Firma.dev? Du kannst deinen API-Schlüssel erhalten und in wenigen Minuten mit dem Entwickeln beginnen. Preise nach Verbrauch: 0,029 € pro Umschlag, keine Verträge oder Mindestmengen.

Kostenlos loslegen

Das vollständige Änderungsprotokoll findest du in der API-Dokumentation.