Obtenir une liste de vos demandes | 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.

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 (English only) Tarification Blog
Règles d'utilisation de l'API Faire des demandes Créer une nouvelle demande Obtenir la liste de vos demandes Obtenir le statut de la demande Obtenir les résultats (courriels traités) Obtenir les résultats (courriels invalides et échoués) Codes d'erreur OAuth de serveur à serveur

Obtenir une liste de vos demandes

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

Exemple de requête CURL

curl https://emailverification.whoisxmlapi.com/api/bevService/request/list -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "page": 1, "onlyIds": false, "perPage": 10, "sort": "desc", "format": "json"}'

Exemple de corps de requête POST

{
    "apiKey": "YOUR_API_KEY",
    "page": 1,
    "format": "json",
    "onlyIds": false,
    "perPage": 10,
    "sort": "desc"
}

Paramètres d'entrée

clé api

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

Optionnel. Entier.

Utilisé pour paginer les ensembles de résultats en conjonction avec "perPage".

Valeur par défaut : 1.
onlyIds

Facultatif. Booléen.

Si c'est vrai, seule la liste des identifiants est renvoyée.

Valeur par défaut : true.
parPage

Optionnel. Entier.

Limite chaque page de l'ensemble de résultats à ce nombre de requêtes.

Min : 10 ; Max : 50.

Valeur par défaut : 10
trier

Facultatif. Chaîne.

Spécifiez l'ordre des demandes dans la réponse.

Valeurs autorisées : "asc", "desc".

Valeur par défaut : "desc".
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": {
        "current_page": 1,
        "data": [
            {
                "id": 596
            },
            {
                "id": 595
            },
            {
                "id": 544
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.
{
    "response": {
        "current_page": 1,
        "data": [
            {
                "id": 596,
                "api_version": 3,
                "date_start": "1528377253",
                "total_emails": 3,
                "invalid_emails": 0,
                "processed_emails": 3,
                "failed_emails": 0,
                "ready": 1
            },
            {
                "id": 595,
                "api_version": 3,
                "date_start": "1528377227",
                "total_emails": 20,
                "invalid_emails": 0,
                "processed_emails": 20,
                "failed_emails": 0,
                "ready": 1
            },
            {
                "id": 544,
                "api_version": 2,
                "date_start": "1528204702",
                "total_emails": 500,
                "invalid_emails": 0,
                "processed_emails": 500,
                "failed_emails": 0,
                "ready": 1
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.

Paramètres d'entrée

réponse

L'objet de la réponse.

Contient le champ "data" avec un tableau des données des demandes de l'utilisateur en cas de succès.

Les champs "from" et "to" représentent la plage d'ID de l'ensemble de résultats des demandes renvoyées pour la page en cours.

'per_page' est la taille des pages et 'total' est le nombre de requêtes dans l'ensemble des résultats.

Les champs "current_page" et "last_page" correspondent au nombre de pages de l'ensemble de résultats.

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

Array.

Une liste des éléments d'information de vos demandes (si "onlyIds" est vrai, chaque élément n'a que le champ "id" ).
data[k].id

Chaîne de caractères.

ID de la demande.
data[k].api_version

Entier.

Version de l'API utilisée pour la demande.
data[k].date_start

Chaîne de caractères.

Représentation sous forme de chaîne de caractères de l'horodatage Unix du début de la demande.
data[k].total_emails

Entier.

Le nombre total de courriels dans la demande.
data[k].invalid_emails

Entier.

Nombre de courriels non valides.
data[k].processed_emails

Entier.

Nombre d'adresses électroniques déjà traitées.
data[k].failed_emails

Entier.

Nombre de courriels qui n'ont pas pu être traités.
data[k].ready

Entier.

1 si le traitement est terminé, 0 sinon.
de

Entier.

ID de la demande minimale dans la page actuelle de l'ensemble de données.
à

Entier.

ID de demande maximale dans la page actuelle de l'ensemble de données.
par page

Entier.

Nombre maximal de demandes pour chaque page de l'ensemble des résultats.
total

Entier.

Le nombre total de demandes dans l'ensemble de résultats.
page_actuelle

Entier.

Numéro de la page actuelle dans l'ensemble des résultats.
dernière_page

Entier.

Le numéro de la dernière page du jeu.
erreur

Chaîne de caractères.

Description de l'erreur.
erreurs

Array.

Plusieurs messages d'erreur.