Obtenir des résultats (emails traités) | Documentation | Email Verification Bulk API | WhoisXML API
Produits APIs Flux de données Outils Web Recherche et surveillance de domaines Packs Entreprise
WHOIS / WHOIS History
WHOIS / WHOIS History

Fournir des informations actuelles et historiques sur la propriété des domaines/IP. Identifier toutes les connexions entre les domaines, les titulaires, les bureaux d'enregistrement et les serveurs DNS.

DNS / DNS History
DNS / DNS History

Examinez toutes les connexions DNS / IP actuelles et historiques entre les domaines et les enregistrements A, MX, NS et autres. Surveillez les modifications suspectes apportées aux enregistrements DNS.

IP Geolocation / IP Netblocks
IP Geolocation / IP Netblocks

Obtenez le contexte détaillé d'une adresse IP, y compris la géolocalisation de l'utilisateur, le fuseau horaire, les domaines connectés, le type de connexion, la plage IP, l'ASN et d'autres détails relatifs à la propriété du réseau.

Domain Research Suite (DRS)
Domain Research Suite (DRS)

Accédez à notre solution basée sur le web afin d'examiner et de surveiller tous les détails du domaine qui vous intéressent.

Domain Research Suite (DRS)
Domain Research Suite (DRS)

Accédez à une solution d'entreprise basée sur le web pour rechercher et contrôler les enregistrements de domaines et les détails de propriété pour les termes de marque, les correspondances floues, les registrants d'intérêt, et plus encore.

Recherche
Contrôle
Label blanc
WhoisXML API Predictive Threat Intelligence
Predictive Threat Intelligence

Détecter et bloquer l'accès à des noms de domaine dangereux avant que des acteurs malveillants ne les utilisent à des fins criminelles. Contactez-nous dès aujourd'hui pour plus d'informations.

Infrastructure Internet de l’API WhoisXML
Internet Infrastructure

Débloquer des informations intégrées sur les propriétés Internet et leur propriété, leur infrastructure et d'autres attributs.

Enterprise API Packages
Enterprise API Packages

Notre ensemble complet de renseignements sur les domaines, les IP et les DNS est disponible via des appels API sous la forme d'un abonnement annuel à des prix prévisibles.

Security Intelligence (SI) Suite
Security Intelligence (SI) Suite

Offre un accès complet aux données WHOIS, IP, DNS et sous-domaines pour l'enrichissement des produits, la chasse aux menaces et bien plus encore.

Premium API Services
Premium API Services

Bénéficiez d'un accès prioritaire aux données sur notre site premium API services, avec des avantages supplémentaires tels qu'une équipe d'assistance dédiée, une infrastructure de niveau entreprise et des accords de niveau de service (SLA) pour une évolutivité totale et des performances élevées.

L'administration des utilisateurs d'API à plusieurs niveaux est désormais disponible - Gérez des clés API individuelles pour les membres de votre équipe au sein de votre organisation.

En savoir plus
×
Nous contacter
Bulk API docs Integrations Tarification Blog
Règles d’utilisation de l’APIEffectuer des requêtesCréer une nouvelle requêteObtenir une liste de vos requêtesObtenir le statut de la requête Obtenir les résultats (e-mails traités)Obtenir les résultats (e-mails non valides et ayant échoué)Codes d’erreurServer-to-Server OAuth

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": "[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 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 à [email protected] et un autre à l'adresse inexistante [email protected], 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.