Der Email Verifier prüft, ob du an eine E-Mail-Adresse senden kannst. Das lohnt sich zum Beispiel bei Anmeldungen zum Newsletter, bei Kontaktformularen oder bevor du eine ältere Adressliste nutzt. So vermeidest du Rückläufer und schützt den Ruf deiner Absenderdomain.
Die Anfrage
Die Prüfung ist ein GET an /v1/email-verification/ mit der Adresse am Ende des Pfads. Dein Schlüssel gehört ausschließlich in den Header Authorization, nie in die Adresse.
curl "https://api.flowdata.one/v1/email-verification/max.mustermann%40example.com" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Kodiere die Adresse für die URL, vor allem wenn sie Sonderzeichen enthält. Ein + im lokalen Teil, etwa bei anna+newsletter@example.com, schreibst du als %2B, das @ darf als %40 stehen. Die meisten Programmiersprachen haben dafür eine fertige Funktion, in PHP zum Beispiel rawurlencode(). Domains mit Umlauten wie info@müller.example werden erkannt.
Die Antwort
{
"email_address": "max.mustermann@example.com",
"status": "valid",
"source": "LR",
"result": "safe",
"reason": "accepted",
"checks": {
"syntax": true,
"mx": "ok",
"mail_provider": "other",
"disposable": false,
"role_account": false,
"catch_all": false
}
}
- email_address: die geprüfte Adresse.
- status: die einfache Antwort auf die Frage, ob du senden kannst:
valid,risky,invalid,disposableoderunknown. - result: die genauere Einschätzung:
safe,risky,invalidoderunknown. - reason: der Grund für das Ergebnis, zum Beispiel
accepted,catch_alloderrejected. - checks: die einzelnen Prüfungen, also Syntax, Mailserver, Mailanbieter, Wegwerf-Domain, Rollenadresse und Catch-All. Bei älteren gespeicherten Ergebnissen können
reasonundchecksden Wertnullhaben. - source: woher das Ergebnis stammt.
DBist ein gespeichertes Ergebnis,NAdie eigene Prüfung von FlowData, ein anderes Kürzel nennt den angebundenen Prüfdienst.
Was die Werte bedeuten und wie du damit umgehst, steht in Was bedeuten die Ergebnisse des Email Verifiers und wie gehe ich damit um?.
Wie lange dauert eine Prüfung?
FlowData prüft zuerst selbst: Syntax, gespeichertes Ergebnis, Mailserver der Domain, Wegwerf-Domains und bekannte Catch-All-Domains. Das geht schnell. Nur wenn das nicht reicht, werden nacheinander angebundene Prüfdienste gefragt, bis einer eine klare Antwort gibt. Das kann einige Sekunden dauern, im ungünstigen Fall über eine Minute. Stell den Timeout deiner Anfrage deshalb großzügig ein, und prüfe Adressen bei Anmeldungen am besten im Hintergrund statt während die Person auf die Seite wartet.
Wenn die Adresse kein gültiges Format hat
Adressen ohne gültiges Format, also etwa ohne @, lehnt der Email Verifier sofort mit HTTP 400 ab:
{"error":"Invalid email address"}
Eine Domain ohne Mailserver ist dagegen kein Formatfehler. Solche Adressen bekommen HTTP 200 mit "result": "invalid".
Was kostet eine Prüfung?
Berechnet wird nach Verbrauch, der Preis gilt je 1.000 erfolgreiche Prüfungen. Auch ein gespeichertes Ergebnis zählt als Prüfung. Nicht berechnet werden Anfragen mit dem Ergebnis unknown, abgelehnte Adressen mit HTTP 400 und Anfragen, die aus einem anderen Grund fehlschlagen. Die Beträge stehen auf der Preisseite, die für dein Team geltenden Preise findest du in FlowData unter Abrechnung.
Reicht dein Guthaben nicht oder ist ein Ausgabenlimit erreicht, antwortet die API mit HTTP 402 und dem Code insufficient_quota oder spend_limit_exceeded. Ohne gültigen Schlüssel kommt HTTP 401. Mehr dazu steht in Welche Fehlermeldungen liefern die FlowData-APIs und was bedeuten sie?.
Gut zu wissen
- Jede Prüfung steht mit der geprüften Adresse im Protokoll des Bereichs. Einzelne Anfragen werden dort 30 Tage aufbewahrt, siehe Wie lese ich Statistik und Protokoll eines FlowData-Bereichs?.
- Rufst du den Email Verifier noch über eine ältere Adresse auf, vielleicht sogar mit dem Schlüssel im Pfad, stell sie um. Wie das geht, steht in Wie stelle ich meine Integration auf api.flowdata.one um?.
- Für ganze Newsletter-Listen musst du nichts programmieren. FlowSend prüft eine Liste direkt in der Oberfläche, siehe FlowSend: Liste prüfen und säubern.