Créer une nouvelle requête | Documentation | Email Verification Bulk API | WhoisXML API

Créer une nouvelle demande

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

Exemple de requête CURL

curl https://emailverification.whoisxmlapi.com/api/bevService/request -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "version": 3, "emails": ["[email protected]", "[email protected]", "[email protected]"], "format": "json"}'

Exemple de corps de requête POST

{
    "apiKey": "YOUR_API_KEY",
    "version": 3,
    "emails": [
        "[email protected]",
        "[email protected]",
        "[email protected]"
    ],
    "format": "json"
}

Paramètres d'entrée

clé api

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

courriels

Requis. Array.

Contient un tableau d'adresses électroniques à vérifier.

version

Optionnel. Nombre.

Définit la version de l'API de vérification des courriels à utiliser.

Valeurs autorisées : 2 et 3.

Valeur par défaut : 2. Veuillez utiliser la version 3 de l'API après le 30 avril 2024.

REMARQUE : la version 2 de l'API de vérification des courriels est obsolète suite au lancement de la version 3, qui offre une meilleure stabilité et des résultats plus précis. une meilleure stabilité et des résultats plus précis. Pour en savoir plus sur la nouvelle version, veuillez consulter cette page des spécifications. Après le 30 avril 2024, l'API v2 sera supprimée et les requêtes ne seront plus servies.

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": {
        "id": 5
    }
}

Code: 200 OK.
{
    "response": {
        "errors": [
            "The format field should have one of the following values: json, xml."
        ]
    }
}

Code: 400 Bad Request.
{
    "response": {
        "error": "Authorisation or authentication failed"
    }
}

Code: 401 Unauthorized.
{
    "response": {
        "error": "Insufficient balance"
    }
}

Code: 402 Payment Required.
réponse

L'objet de la réponse.

Contient le champ entier "id" en cas de succès.

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

id

Entier.

ID de la demande de vérification nouvellement créée.

erreur

Chaîne de caractères.

Description de l'erreur.

erreurs

Array.

Plusieurs messages d'erreur.