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

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

clé api

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

id

Requis. Entier.

ID de la demande.

format

Facultatif. Chaîne.

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.
réponse

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

résultat

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' (échec du SMTP ) 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'.

Adresse électronique
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. de plusieurs façons intéressantes.
smtpCheck
Vérifie que l'adresse électronique existe et qu'elle peut recevoir des courriels en utilisant la connexion SMTP et les techniques d'émulation d'envoi de courriels. techniques d'émulation de l'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. recevoir des courriels par SMTP, et "false" si l'adresse électronique n'existe pas sur le serveur SMTP cible ou si elle n'a temporairement pas pu recevoir de messages. ou ne peut temporairement pas 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 serveur SMTP. 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
Assure que le domaine de l'adresse électronique, par exemple : gmail.com, est un domaine valide. Cette valeur sera Cette valeur sera "true" si le domaine est valide et "false" dans le cas contraire. Peut être 'null' pour les emails invalides ou inexistants. 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. '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 dispose ou non d'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. domaine. Les adresses "attrape-tout" sont courantes dans les entreprises : si vous envoyez un courriel à [email protected] et un autre courriel à l'adresse inexistante [email protected], le serveur de messagerie ne recevra pas de courriel. un autre courriel à l'adresse inexistante [email protected], ces deux courriels arriveront dans la même boîte de réception. Les valeurs possibles sont "true" (vrai) ou "false" (faux). 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.