Obtenir des résultats (emails 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
}

Input parameters

apiKey

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

id

Requis. Integer.

ID de la demande.

format

Facultatif. String.

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

Valeurs autorisées : "xml", "json", "csv".

Valeur par défaut : "json".

Exemple de sortie

{
    "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.
response

L'objet de la réponse.

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 "error". S'il y a plusieurs erreurs, leurs descriptions sont renvoyées dans le tableau "errors".

result

Le champ « résultat » peut contenir quatre valeurs : « ok », « inconnu », « smtp-échoué », « incorrect ». La valeur « ok » signifie que l' e-mail a passé avec succès les vérifications SMTP et DNS, et que cette adresse e-mail n'est pas jetable. La valeur « bad » signifie que certains de ces contrôles (à l'exception du contrôle SMTP) ont échoué. La valeur « smtp-failed » signifie que l'adresse e-mail n'existe pas sur le serveur SMTP cible ou qu'elle ne peut temporairement pas recevoir de messages. La valeur « unknown » signifie que l'hébergement de messagerie prend en charge la fonctionnalité « catch all ».

emailAddress
L'adresse électronique à vérifier.
formatCheck
Vous indique s'il y a des erreurs de syntaxe dans l'adresse électronique. Il s'agit d'une vérification de base 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 gère tous ces types de vérifications pour vous dans un certain nombre d'outils intéressants. 
smtpCheck
Vérifie si l'adresse e-mail existe et peut recevoir des e-mails à l'aide d'une connexion SMTP et de 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 e-mail n'existe pas sur le serveur SMTP cible ou ne peut temporairement pas recevoir de messages. La valeur sera « null » si la requête SMTP n'a pas pu être exécutée, si la vérification de la boîte aux lettres n'est pas prise en charge par le fournisseur de messagerie cible ou si elle n'est pas applicable.
dnsCheck
Assure que le domaine de l'adresse électronique, par exemple : gmail.com, est un domaine valide. Cette valeur sera  "true" si le domaine est valide et "false" dans le cas contraire. Peut être 'null' pour les emails invalides ou inexistants.
freeCheck
Vérifiez si l'adresse électronique provient d'un fournisseur d'accès gratuit comme Gmail ou non. Cette valeur sera sera "false" si l'adresse électronique n'est pas gratuite, et "true" dans le cas contraire. Peut être 'null' pour les emails invalides ou invalides ou inexistantes.
disposableCheck
Indique si l'adresse électronique est jetable (créée par un service comme Mailinator). Cela vous permet de vérifier qu'il n'y a pas d'abus. Cette valeur sera "false" si l'adresse n'est pas jetable, et "true" dans le cas contraire. La valeur peut être "null" pour les adresses électroniques non valides ou inexistantes.
catchAllCheck
Indique si ce serveur de messagerie possède ou non une adresse "fourre-tout". Il s'agit d'un type spécial d'adresse d'adresse qui peut recevoir des courriels pour n'importe quel nombre d'adresses électroniques inexistantes sous un domaine particulier. Les adresses "fourre-tout" sont courantes dans les entreprises : si vous envoyez un courriel à [email protected] et un autre à [email protected], ces deux courriels seront envoyés 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 courriels non valides ou inexistants.
mxRecords
Liste des serveurs de messagerie. Peut être absent pour les courriels invalides ou inexistants.