Leitfäden
E-Mail-Adressen im Registrierungsformular prüfen
Prüfen Sie das Format im Browser und die Adresse auf Ihrem Server. Bestätigen Sie den Zugriff auf das Postfach, bevor Sie davon abhängige Zugänge freigeben. Unklare Ergebnisse bleiben von eindeutigen Fehlern getrennt.
Was bei jeder Antwort zu tun ist
Jedes Mal dieselben vier Ergebnisse. Die Anweisung ändert sich mit der Situation, weil sich mit ihr ändert, was ein Fehler kostet.
| Ergebnis | Was hier zu tun ist |
|---|---|
| Zustellbar | Registrierung fortsetzen. Wenn Zugang oder Kontowiederherstellung vom Postfach abhängen, lassen Sie die Adresse bestätigen. Ein zustellbares Ergebnis belegt nicht, wer darauf zugreifen kann. |
| Riskant | Aktion und Gründe lesen. Catch-all-Domains und Rollenpostfächer können legitim sein. Gegebenenfalls mit Bestätigung fortfahren; für Wegwerfadressen kann Ihre Regel für Testkonten eine eigene Entscheidung vorsehen. |
| Nicht zustellbar | Vor Abschluss einer Registrierung, die E-Mail benötigt, um Korrektur bitten. Das Problem mit der Adresse erklären und den eingegebenen Wert zum Bearbeiten erhalten. |
| Unbekannt | Die Registrierung mit Bestätigung des Postfachs ermöglichen. Es liegen keine eindeutigen Belege vor; die Adresse ist damit nicht als ungültig erwiesen. Bei Bedarf später erneut prüfen. |
Formathinweise im Browser geben
Verwenden Sie ein E-Mail-Feld mit sichtbarer Beschriftung und erklären Sie Fehler direkt daneben. Der Browser kann ein fehlendes @ oder eine unvollständige Domain erkennen, aber keine Postfachexistenz feststellen. Lassen Sie den eingegebenen Wert stehen, damit eine Korrektur mit einer Bearbeitung möglich ist.
Prüfen Sie beim Absenden. Wenn Sie zusätzlich nach dem Verlassen des Feldes prüfen, vermeiden Sie API-Aufrufe bei jedem Tastendruck. Ändert sich die Eingabe, verwerfen Sie das Ergebnis für den alten Wert. Eine verspätete Antwort darf die inzwischen korrigierte Adresse nicht als ungültig markieren.
Die Entscheidung auf dem Server treffen
Ihr Registrierungs-Endpunkt sendet die Adresse an POST /v1/verifications. Der Bearer-Schlüssel bleibt auf dem Server. Wiederholen Sie dort die nötigen Eingabeprüfungen, denn Browserprüfungen lassen sich umgehen. Die Seite zur E-Mail-Verifizierungs-API erläutert Anfrage und Antwortfelder.
Lesen Sie status, action und reason_codes zusammen. Die Aktionen heißen allow, allow_with_email_confirmation und reject. Die Tabelle oben zeigt eine mögliche Regel für die Registrierung, keine feste Zuordnung von Status zu Aktion.
Tippfehler vorschlagen, ohne die Adresse zu ändern
INVALID_SYNTAX und DNS_NXDOMAIN können einen eindeutigen Format- oder Domainfehler erklären. LIKELY_DOMAIN_TYPO weist auf eine mögliche Korrektur hin. Zeigen Sie den Vorschlag neben der eingegebenen Adresse und lassen Sie die Person entscheiden. Eine ungewöhnliche Domain kann beabsichtigt sein.
Prüfen Sie nach einer Korrektur die neue Adresse und ordnen Sie ihr das Ergebnis zu. Ändern Sie keine Domain stillschweigend, entfernen Sie keine Plus-Tags und behandeln Sie ein Rollenpostfach nicht als Tippfehler.
Ausstehende Prüfungen und fehlende Antworten behandeln
Eine vollständige Prüfung kann pending mit id und retry_after_ms liefern. Warten Sie das Intervall ab und rufen Sie dann mit demselben Schlüssel GET /v1/verifications/{id} auf. Fragen Sie nur ab, solange die Prüfung läuft, und setzen Sie eine Frist für das Formular. Es gibt keine Callbacks.
Nach Ablauf der Frist gilt Ihre Ersatzregel: etwa mit Bestätigung fortfahren und die Prüfung später abschließen. Bezeichnen Sie diese lokale Zeitüberschreitung nicht als API-Ergebnis unknown oder als ungültige Adresse. Auch HTTP-Fehler betreffen Anfrage oder Dienst, nicht die Adresse. Die Seite zur Echtzeit-Verifizierung erklärt den Warteablauf.
Den Zugriff auf das Postfach bestätigen
Emvero versendet keine Bestätigungs-E-Mail. Eine vollständige SMTP-Prüfung endet vor der Nachrichtenübertragung. Selbst ein positiver Serverbefund zeigt nicht, ob die Person bei der Registrierung Zugriff auf das Postfach hat. Senden Sie eine eigene Bestätigung, wenn Zugang oder Wiederherstellung davon abhängen, und setzen Sie diese Bedingung auf dem Server durch.
Ergänzen Sie für den Missbrauchsschutz passende Kontrollen gegen wiederholte Konten und Bots. DISPOSABLE_DOMAIN kann eine E-Mail-Regel beeinflussen, ist aber kein Betrugsnachweis. Der Leitfaden zum Missbrauch von Testkonten behandelt diese Entscheidung.
Reason Codes, die hier etwas entscheiden
Diese Codes gehören zum Vokabular der API und erklären eine Prüfung. Die Hinweise kennzeichnen auch Werte, die die aktuelle Prüfregel oder SMTP-Probe nicht zurückgibt.
INVALID_SYNTAX | Adresse ist nicht wohlgeformt |
LIKELY_DOMAIN_TYPO | Domain sieht nach Tippfehler aus |
DNS_NXDOMAIN | Domain existiert nicht |
DISPOSABLE_DOMAIN | Anbieter von Wegwerfadressen |
Begriffe, die vorher hilfreich sind
E-Mail-Syntax
Formatregeln, die vor Netzwerkabfragen geprüft werden. Ein gültiges Format belegt weder eine funktionierende Domain noch ein Postfach.
Wegwerf-E-Mail-Adresse
Eine Adresse bei einem Anbieter temporärer Postfächer. Das Domain-Signal betrifft Nutzungsdauer und Regeln, nicht den Nachweis eines Zustellfehlers.
Greylisting
Eine vorübergehende SMTP-Ablehnung fordert zu einem späteren Versuch auf. Dieser kann zusätzliche Belege liefern.
Die Entscheidung dahinter
Testen Sie es an einer Adresse, die Sie kennen.
Der kostenlose Checker liefert das vollständige Ergebnis - jede Stufe, jeden Reason Code, nichts zurückgehalten.