Obtenir des résultats (emails traités) | Documentation | Email Verification Bulk API | WhoisXML API

Obtenir des résultats (e-mails traités)

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

Exemple de requête CURL

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"}'

Exemple de corps de requête POST

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

Paramètres d'entrée

apiKey

Nécessaire. Obtenez votre clé API personnelle sur la page Mes produits.

id

Obligatoire. Entier.

ID de la demande.

format

Facultatif. string.

Permet de spécifier le format de réponse.

Valeurs autorisées : « xml », « json », « csv ».

Valeur par défaut : « json ».

Exemple de sortie

{
    "response": [
        {
            "emailAddress": "alex@alex.edu",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "bob@google.com",
            "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": "mila@yahoo.com",
            "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.
response

L’objet response.

Contient un tableau de résultats de vérification pour chaque adresse électronique de la demande initiale (voir la documentation ci-dessous).

Les réponses à ces demandes peuvent être enregistrées directement sur le disque.

En cas d’erreur, il contient sa description dans le champ 'erreur' . S’il y a plusieurs erreurs, leurs descriptions sont renvoyées dans le tableau 'errors' .

result

Le champ de résultat peut contenir quatre valeurs : 'ok', 'unknown', 'smtp-failed', 'bad'. La valeur "ok" signifie que le email a passé avec succès le contrôle SMTP, le contrôle DNS, et que cette adresse email n'est pas jetable. La valeur 'bad' signifie que certaines de ces vérifications (à l'exception de la vérification SMTP) ont échoué. La valeur 'smtp-failed' signifie que l'adresse e-mail n'existe pas sur le serveur SMTP cible ou que l'adresse temporaire n'a pas pu recevoir de messages. La valeur 'unknown' signifie que l'hébergement du courrier électronique prend en charge la fonction 'catch all'.

emailAddress
L’adresse e-mail à vérifier.
formatCheck
Vous permet de savoir s’il y a des erreurs de syntaxe dans l’adresse e-mail. Il s’agit d’une vérification de base qui est faite pour détecter les fautes de frappe simples ou les erreurs majeures. Cette valeur sera 'true's'il n'y a pas d'erreurs, et « false » dans le cas contraire. En coulisses, le service API s’occupe de tous ces types de vérification pour vous de plusieurs manières intéressantes.
smtpCheck
Vérifie si l’adresse e-mail existe et peut recevoir des e-mails à l’aide de la connexion SMTP et techniques d’émulation d’envoi d’e-mails. Cette valeur sera 'true' si l'adresse e-mail existe et peut recevoir des e-mails via SMTP et 'false' si l'adresse email n'existe pas sur le serveur SMTP cible ou n’a temporairement pas pu recevoir de messages. La valeur sera nulle si la requête SMTP n'a pas pu être complétée, si la vérification de la boîte aux lettres n'est pas prise en charge par le fournisseur de la boîte aux lettres cible, ou si elle n'est pas applicable.
dnsCheck
Garantit que le domaine dans l’adresse e-mail, par exemple : gmail.com, est un domaine valide. Cette valeur sera 'true' si le domaine est bon et 'false' dans le cas contraire. Peut être 'null' pour un e-mails invalide ou inexistant.
freeCheck
Vérifiez si l’adresse e-mail provient d’un fournisseur de messagerie gratuit comme Gmail ou non. Cette valeur Être « faux » si l’adresse e-mail n’est pas libre, et « vrai » dans le cas contraire. Peut être 'null' pour invalid ou e-mails inexistants.
disposableCheck
Vous indique si l’adresse e-mail est jetable ou non (créée via un service comme Mailinator). Cela vous aide à vérifier s’il y a des abus. Cette valeur sera « false » si l’e-mail n’est pas jetable, et 'true' sinon. Peut être « null » pour les e-mails invalides ou inexistants.
catchAllCheck
Indique si ce serveur de messagerie dispose ou non d'une adresse « attrape-tout ». Il s'agit d'un type d'adresse spécial qui peut recevoir des e-mails pour un nombre quelconque d'adresses électroniques inexistantes sous un domaine particulier. Les adresses « attrape-tout » sont courantes dans les entreprises : si vous envoyez un e-mail à test@hi.com et un autre à l'adresse inexistante test2@hi.com, ces deux e-mails arriveront dans la même boîte de réception. Les valeurs possibles sont "true" ou "false". La valeur "null" peut être utilisée pour les emails non valides ou inexistants.
mxRecords
Liste des serveurs de messagerie. Peut être absent pour des e-mails invalides ou inexistants.