Ergebnisse abrufen (verarbeitete E-Mails)

POST https://emailverification.whoisxmlapi.com/api/bevService/request/completed

Beispiel einer CURL-Anfrage

curl https://emailverification.whoisxmlapi.com/api/bevService/request/completed -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "id": 622, "format": "json"}'

Beispiel für einen POST-Anfragetext

{
    "apiKey": "YOUR_API_KEY",
    "id": 596,
    "format": "csv"
}

Eingabe-Parameter

apiKey

Erforderlich. Sie erhalten Ihren persönlichen API-Schlüssel auf der Seite Meine Produkte.

id

Erforderlich. Ganze Zahl.

ID der Anfrage.

Format

Optional. Zeichenfolge.

Wird verwendet, um das Antwortformat anzugeben.

Erlaubte Werte: "xml", "json", "csv".

Standardwert: "json".

Beispielhafte Ausgabe

{
    "response": [
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "alt2.aspmx.l.google.com",
                "alt3.aspmx.l.google.com",
                "alt4.aspmx.l.google.com",
                "aspmx.l.google.com",
                "alt1.aspmx.l.google.com"
            ],
            "result": "unknown"
        },
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "true",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "mta6.am0.yahoodns.net",
                "mta5.am0.yahoodns.net",
                "mta7.am0.yahoodns.net"
            ],
            "result": "unknown"
        }
    ]
}

Code: 200 OK.
{
    "response": {
        "error": "Wrong request id"
    }
}

Code: 422 Unprocessable Entity.
Antwort

Das Antwortobjekt.

Enthält ein Array mit den Überprüfungsergebnissen für jede E-Mail-Adresse in der ursprünglichen Anfrage (siehe die Dokumentation unten).

Die Antworten auf diese Anfragen können direkt auf der Festplatte gespeichert werden.

Im Falle eines Fehlers enthält es dessen Beschreibung im Feld 'Fehler'. Wenn es mehrere Fehler gibt, werden deren Beschreibungen im Array 'Fehler' zurückgegeben.

Ergebnis

Das Ergebnisfeld kann vier Werte enthalten: 'ok', 'unknown', 'smtp-failed', 'bad'. Der Wert 'ok' bedeutet, dass die E-Mail die SMTP-Prüfung und die DNS-Prüfung erfolgreich durchlaufen hat und das es keine Einweg-E-Mail-Adresse ist. Der Wert 'bad' bedeutet, dass einige dieser Prüfungen (außer der SMTP-Prüfung) fehlgeschlagen sind. Der Wert 'smtp-failed' bedeutet bedeutet, dass die E-Mail-Adresse auf dem Ziel-SMTP-Server nicht existiert oder vorübergehend keine Nachrichten empfangen werden konnten. Der Wert 'unknown' bedeutet, dass das E-Mail-Hosting die "Catch-All-Funktion" unterstützt.

emailAddress
Die zu überprüfende E-Mail-Adresse.
formatCheck
Zeigt Ihnen an, ob die E-Mail-Adresse Syntaxfehler enthält. Dies ist eine grundlegende Prüfung, die um einfache Tippfehler oder größere Fehler zu erkennen. Dieser Wert ist 'true', wenn keine Fehler vorhanden sind, und andernfalls 'falsch'. Hinter den Kulissen übernimmt der API-Dienst alle Arten dieser Überprüfungen auf verschiedene interessante Weise für Sie.
smtpCheck
Überprüft, ob die E-Mail-Adresse existiert und E-Mails empfangen kann, indem eine SMTP-Verbindung und Techniken zur E-Mail-Sendeemulation verwendet werden. Dieser Wert ist 'true', wenn die E-Mail-Adresse existiert und und E-Mails über SMTP empfangen kann, und 'false', wenn die E-Mail-Adresse auf dem Ziel-SMTP-Server nicht existiert oder vorübergehend keine Nachrichten empfangen konnte. Der Wert ist null, wenn die SMTP-Anforderung nicht abgeschlossen werden konnte, die Postfachüberprüfung beim Zielpostfachanbieter nicht unterstützt wird oder nicht anwendbar ist.
dnsCheck
Stellt sicher, dass die Domain in der E-Mail-Adresse, z.B.: gmail.com, eine gültige Domain ist. Dieser Wert ist 'true', wenn die Domain gültig ist und 'false' andernfalls. Kann 'null' sein für ungültige oder nicht existierende Emails.
freeCheck
Prüfen Sie, ob die E-Mail-Adresse von einem kostenlosen E-Mail-Anbieter wie Gmail stammt oder nicht. Dieser Wert wird ist 'false', wenn die E-Mail-Adresse nicht kostenlos ist, und andernfalls 'true'. Kann 'null' sein für ungültige oder nicht existierende E-Mails.
EinwegCheck
Hier erfahren Sie, ob es sich um eine Einweg-E-Mail-Adresse handelt (die über einen Dienst wie Mailinator erstellt wurde). Dies hilft Ihnen bei der Überprüfung auf Missbrauch. Dieser Wert ist 'false', wenn es kein Einweg-E-Mail ist, und sonst 'true'. Kann bei ungültigen oder nicht existierenden E-Mails 'null' sein.
catchAllCheck
Gibt an, ob dieser Mailserver eine Catch-All-Adresse hat. Dies bezieht sich auf einen speziellen Adresstyp, der E-Mails von einer beliebigen Anzahl nicht vorhandener E-Mail-Adressen einer bestimmten Domain empfangen kann. Catch-All-Adressen sind in Unternehmen üblich. Wenn Sie eine E-Mail an [email protected] und eine eine andere E-Mail an die nicht existierende Adresse [email protected] senden, landen beide E-Mails im selben Posteingang. Mögliche Werte sind 'true' oder 'false'. Für ungültige oder nicht existierende E-Mails kann auch 'null' angegeben werden.
mxRecords
Liste der Mailserver. Kann bei ungültigen oder nicht existierenden E-Mails nicht vorhanden sein.