E-Mail-Adressen bei der Registrierung prüfen

Die Adresse über Ihren Server prüfen

Im Browser können Sie das Adressformat prüfen und auf offensichtliche Eingabefehler hinweisen. Die Anfrage an Emvero sendet Ihr Backend. Dafür benötigen Sie ein Konto mit Credit-Guthaben und einen API-Schlüssel, der auf Ihrem Server bleibt und nicht im Browsercode erscheint.

Ohne Angabe einer Prüftiefe verwendet die API die vollständige Prüfung. Die folgende Anfrage zeigt den Aufruf:

curl -sS https://api.emvero.tech/v1/verifications \
  -H "Authorization: Bearer emv_your_credential" \
  -H "Content-Type: application/json" \
  -d '{"email":"ada@example.com"}'

Die Antwort enthält die Kennung id, den Status status, die Handlungsempfehlung action, die einzelnen Prüfergebnisse checks und die Gründe reason_codes. Der folgende Ausschnitt veranschaulicht eine mögliche Antwort. Er ist keine tatsächliche Prüfung von example.com:

{
  "id": "5f0b6f3e-1a4c-4a1f-9d2e-8f7b3c2a1d90",
  "status": "risky",
  "action": "allow_with_email_confirmation",
  "checks": { "syntax": "valid", "mail_routing": "valid", "accept_all": "yes" },
  "reason_codes": ["ACCEPT_ALL_DOMAIN"]
}

Im Beispiel ist Catch-all-Verhalten belegt: Die Domain nimmt beliebige Empfänger an. Die Annahme allein bestätigt deshalb kein bestimmtes Postfach. Emvero liefert risky und empfiehlt mit allow_with_email_confirmation, die Adresse zusätzlich bestätigen zu lassen.

Derselbe Status kann bei anderen Belegen zu einer anderen Handlungsempfehlung führen. Ihre Anwendung kann die Empfehlung übernehmen oder die einzelnen Prüfergebnisse und Reason Codes nach eigenen Regeln auswerten. Alle Antwortfelder beschreibt die Seite zur E-Mail-Verifizierungs-API.

Das Ergebnis im Formular verwenden

Für die Entscheidung lesen Sie status und action zusammen. Die API kann drei Handlungsempfehlungen liefern. Bei einer noch laufenden Prüfung müssen Sie zusätzlich festlegen, wie das Formular mit pending umgeht:

Antwort der API	Möglicher nächster Schritt
allow	Den Ablauf fortsetzen.
allow_with_email_confirmation	Fortfahren und die Adresse per E-Mail bestätigen lassen.
reject	Um eine andere Adresse oder eine Korrektur bitten.
pending	Bis zur eigenen Frist warten. Danach nach Ihrer Regel fortfahren oder den Schritt vorerst anhalten.

Die ersten drei Werte gehören zum Feld action. pending ist dagegen ein Wert von status und bezeichnet eine noch nicht abgeschlossene Prüfung. Ein endgültiges Ergebnis unknown bedeutet, dass die verfügbaren Belege für eine Entscheidung nicht ausreichen. Es ist kein Nachweis für ein ungültiges Postfach.

Auch confidence ist kein Maß für die Wahrscheinlichkeit einer Zustellung. Der Wert von 0 bis 1 beschreibt die Stärke der Belege.

Wenn ein Eingabefehler auffällt, kann die Person ihre Adresse korrigieren, bevor Sie den Kontakt oder das Konto speichern. Wie Sie die Prüfung in Frontend und Backend einbauen, erklärt der Leitfaden für Registrierungsformulare.

Bei „pending“ das Ergebnis später abrufen

Manche Postfachprüfungen dauern länger als die Wartezeit, die Sie für Ihr Formular vorsehen. Bei pending erhalten Sie eine Kennung für den späteren Abruf und mit retry_after_ms ein empfohlenes Warteintervall:

{
  "id": "5f0b6f3e-1a4c-4a1f-9d2e-8f7b3c2a1d90",
  "status": "pending",
  "retry_after_ms": 2000
}

Im Beispiel beträgt das Intervall 2000 Millisekunden. Warten Sie diese Zeit ab und rufen Sie dann mit demselben API-Schlüssel GET /v1/verifications/{id} auf. Solange der Status pending lautet, fragen Sie nach dem jeweils zurückgegebenen Intervall erneut ab. Emvero übermittelt spätere Ergebnisse nicht automatisch per Callback; Ihre Anwendung muss sie abrufen. Den Ablauf beschreibt die Dokumentation zu ausstehenden Ergebnissen.

Begrenzen Sie unabhängig davon die Wartezeit im Formular. Für einen Schritt mit hohem Risiko können Sie festlegen, dass er erst nach einem endgültigen Ergebnis freigegeben wird. In anderen Fällen können Sie die Registrierung mit einer zusätzlichen E-Mail-Bestätigung fortsetzen und das Prüfergebnis später abrufen. Welche Regel passt, hängt von Ihrer Anwendung ab.

Eine überschrittene Wartezeit oder ein API-Fehler liefert kein undeliverable-Ergebnis. Beides sagt für sich genommen nichts darüber aus, ob die Adresse E-Mails empfangen kann.

Wann Sie zusätzlich eine E-Mail-Bestätigung brauchen

Emvero prüft das Adressformat, die Domain und den Mailweg. Eine vollständige Prüfung kann zusätzlich die Antwort des Mailservers auf den angegebenen Empfänger auswerten, sofern der Server dies zulässt. Die SMTP-Probe endet vor der Übertragung von Nachrichtendaten und sendet keine E-Mail. Gibt der Mailserver keine eindeutige Auskunft, kann das Postfach ungeklärt bleiben. Auch die Annahme eines Empfängers garantiert keine spätere Zustellung.

Wenn Sie wissen müssen, ob die Person Zugriff auf das Postfach hat, lassen Sie die E-Mail-Adresse separat bestätigen. Für den Schutz vor Bots, wiederholten Registrierungen oder Betrug benötigen Sie weitere Kontrollen.

Bereits gespeicherte Adressen können Sie mit der Bulk-Verifizierung prüfen. Dabei läuft die Verarbeitung in Ihrem eigenen System; die API liefert dasselbe Ergebnismodell wie bei der Prüfung im Formular.