E-Mail-Prüfung ┅ KRAKE

Was wird geprüft?

Die E-Mail-Prüfung kombiniert lokale Syntaxprüfungen, Merkmale bekannter Domains und DNS-Abfragen. Sie erkennt beispielsweise ungültige Schreibweisen, bekannte Wegwerfadressen und Domains ohne Mailannahme. Der API-Produktwert lautet email_verification.

Eine E-Mail-Liste prüfen

Öffnen Sie die E-Mail-Prüfung in der Konsole und laden Sie eine CSV-Datei mit der Spalte email hoch. Die Vorschau zeigt die erkannten Adressen, Dubletten und offensichtliche Formatfehler. Starten Sie die Prüfung und öffnen Sie den Durchlauf anschließend auf derselben Werkzeugseite.

email
info@beispielbusiness.de
kontakt@beispielwerk.example

E-Mail-Vorlage herunterladen. Die Beispieldomains sind fiktiv; ihre Prüfung ist kein Beispiel für ein positives DNS-Ergebnis.

curl --fail-with-body "https://api.krake.run/api/v1/email-verification/batches/" \
  -H "X-API-Key: $KRAKE_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"product":"email_verification","input_data":{"email":"info@beispielbusiness.de"}}'

Eine Einzelprüfung antwortet gewöhnlich mit HTTP 200 und dem Prüfergebnis unter result, zusammen mit batch_id und id des Datensatzes. Dauert die Prüfung länger, antwortet sie mit HTTP 202; fragen Sie dann /email-verification/records/{id}/ ab. Die Werkzeugoberfläche filtert offensichtliche Formatfehler vorab. Per API eingereichte ungültige Adressen können dagegen ein reguläres Prüfergebnis erzeugen.

Prüfstatus richtig lesen

Ergebnis der E-Mail-Prüfung
Status	Aussage	Praktischer Umgang
`accepts_mail`	Die Domain besitzt eine unterstützte Mailkonfiguration, über MX oder einen impliziten Mailweg.	Als technisch plausible Domain einstufen; die konkrete Mailbox bleibt unbestätigt.
`risky`	Die Domain besitzt einen Mailweg, gilt aber aufgrund der Domain oder des MX-Servers als Wegwerfangebot.	Gemäß Ihrer eigenen Regeln gesondert behandeln; die Klassifikation ist kein Beweis für eine ungültige Mailbox.
`undeliverable`	Ein Syntaxfehler oder ein fehlender beziehungsweise unbrauchbarer Mailweg wurde festgestellt.	`reason` auswerten und die Adresse korrigieren oder aussortieren.
`unknown`	Es liegt keine eindeutige Bewertung vor, beispielsweise bei einer DNS-Zeitüberschreitung.	Separat behandeln und bei einem temporären Fehler später erneut prüfen.

Gründe und Merkmale

Gründe eines Prüfergebnisses
reason	Bedeutung
`invalid_syntax`	Die Adresse besteht die Syntaxprüfung nicht.
`disposable_domain`, `disposable_mx`	Wegwerfangebot über die Domain oder den MX-Server erkannt; bei nutzbarem Mailweg lautet der Status `risky`.
`mx_ok`	MX-Einträge für die Domain vorhanden.
`implicit_mx`	Kein expliziter MX; eine auflösbare A-/AAAA-Adresse ermöglicht einen impliziten Mailweg.
`null_mx`	Die Domain erklärt ausdrücklich, keine E-Mail anzunehmen.
`no_mx_record`	Weder ein verwendbarer MX noch ein impliziter Mailweg gefunden.
`domain_not_found`	Die Domain existiert laut DNS nicht.
`mx_unresolvable`	Gefundene MX-Server konnten nicht zu einer nutzbaren Adresse aufgelöst werden.
`dns_timeout`	Die DNS-Prüfung blieb ohne abschließende Antwort.
`dns_error`	Eine DNS-Störung ließ keine eindeutige Bewertung zu.
`syntax_ok`	Zwischenstand nach bestandener Syntaxprüfung, bevor die DNS-Bewertung abgeschlossen ist.

flags liefert zusätzliche Merkmale: role_account für Funktionsadressen wie info@, unattended etwa für noreply@, free_provider, disposable, idn_domain und idn_local. Ein Funktionspostfach oder kostenloser Anbieter ist dadurch nicht automatisch ungültig.

Ergebnisfelder und Abrechnung

result ist ein flaches Objekt mit einer Bewertung pro Adresse. Es enthält email, status, reason, flags, local_part, domain_part, ascii_domain_part, mx_family, syntax_failure_index und is_disposable. Dieselben Feldnamen stehen im CSV-Export. syntax_failure_index bezeichnet bei einem Syntaxfehler die Zeichenposition ab 0; andernfalls ist es null.

{
  "email": "keine-gueltige-adresse",
  "status": "undeliverable",
  "reason": "invalid_syntax",
  "flags": []
}

Dies ist ein gekürztes Beispiel für eine negative Bewertung. Auch risky, undeliverable und unknown sind Prüfergebnisse und können abgerechnet werden. Der technische Auftragsstatus kann dabei completed sein. Bei CSV-Dateien mit einer Adresse pro Zeile entspricht jede Zeile einem Ergebnisdatensatz.