Qu'est-ce que l'API de vérification des emails ?

L'API de vérification des emails vous permet de valider des adresses email en temps réel via une requête GET. Elle vérifie la syntaxe, les enregistrements MX, les listes noires et effectue une vérification SMTP.

Comment m'authentifier en utilisant l'API ?

Vous devez fournir une clé API valide générée depuis votre tableau de bord EmailVerify.io. Les requêtes sans clé ou avec une clé invalide échoueront.

Quelles vérifications sont effectuées lors de la validation d'un email ?

Les vérifications incluent la validation par regex, la recherche d'enregistrements MX, la vérification des listes noires MX et la vérification de la boîte aux lettres au niveau SMTP.

Quels messages d'erreur l'API peut-elle renvoyer ?

Les erreurs courantes incluent Clé API invalide, Requête invalide, 0 crédits restants et Veuillez réessayer lorsque le serveur rencontre un problème.

Puis-je vérifier mes crédits restants via l'API ?

Oui. Le point de terminaison /check-account-balance/ vous permet de vérifier le statut de l'API, les limites quotidiennes, les crédits de parrainage et les crédits restants.

Documentation de l'API de Vérification d'E-mails

Instructions de vérification instantanée

Introduction

Bienvenue dans l'API de validation d'un seul e-mail d'EmailVerify.io ! Cette API vous permet de valider une seule adresse e-mail en temps réel grâce à une simple requête, garantissant précision et fiabilité pour vos communications par e-mail.

Authentification

Pour accéder à l'API, vous avez besoin d'une clé API valide. Vous pouvez générer votre clé API personnelle depuis la section API après vous être connecté à votre compte. Cette clé est nécessaire pour l'authentification et pour effectuer des requêtes en toute sécurité.

Point de terminaison de l'API

Validez une seule adresse e-mail en remplaçant les espaces réservés par votre clé API unique et l'adresse e-mail à valider dans l'URL suivante :

Obtenir l'URL de la requête (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

Exemple de réponse réussie

Vous obtiendrez une réponse comme celle-ci si votre requête d’un seul e-mail est traitée avec succès :

URL

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

Vérifications effectuées lors de la validation d'un seul e-mail

Validation Regex: Vérifiez la structure des adresses e-mail selon les modèles regex standard de l'industrie pour détecter les fautes de frappe et les erreurs de format avant tout traitement ultérieur.

Validation MX: Vérifiez les enregistrements Mail Exchange (MX) valides pour confirmer que le domaine e-mail est configuré pour recevoir des messages, garantissant qu'il existe et est actif.

Validation de la liste noire MX: Identifiez les domaines figurant sur les listes noires connues pour spam ou activité malveillante, vous aidant à éviter les destinations e-mail peu fiables ou dangereuses.

Validation SMTP: Effectuez une vérification en temps réel en pingant le serveur SMTP du destinataire pour confirmer que l'adresse e-mail est active et capable de recevoir des messages.

Réponses d'erreur

Message d'erreur

Description

Clé API invalide

Si la clé est désactivée ou n'existe pas

Requête invalide

Paramètres invalides dans le point de terminaison de l'API

0 crédits restants

L'utilisateur n'a aucun crédit

Veuillez réessayer

Lorsque quelque chose s'est mal passé de notre côté

Vérifier le solde du compte

Veuillez utiliser la requête GET suivante pour vérifier le solde actuel du compte (crédits quotidiens et instantanés restants).

URL de la requête GET (HTTPS) :

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Ici, remplacez <Your_API_Key> par votre clé API active.

Réponse (JSON) :

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instructions pour la Vérification en Masse

Introduction

Bienvenue sur l'API de Vérification d'Emails en Masse d'EmailVerify.io ! Cette API vous permet de valider jusqu'à 5000 adresses e-mail en temps réel grâce à une simple requête, garantissant précision et fiabilité pour votre communication par e-mail.

Ce point de terminaison vous permet d'envoyer des lots de jusqu'à 5000 e-mails à la fois. Si vous souhaitez effectuer des validations d'un seul e-mail, veuillez utiliser notre point de terminaison pour la validation d'un seul e-mail.

Authentification

Pour accéder à l'API, vous aurez besoin d'une clé API valide. Générez votre clé personnelle depuis la section API après vous être connecté à votre compte. Cette clé est requise pour l'authentification et pour effectuer des requêtes en toute sécurité.

Point de Terminaison API

Validez une seule adresse e-mail en remplaçant les espaces réservés par votre clé API unique et l'adresse e-mail à valider dans l'URL suivante

URL de Requête POST (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

Requête POST

Vous pouvez valider jusqu'à 5000 adresses e-mail en les soumettant dans la requête POST suivante.

Requête POST

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

Exemple de Réponse Réussie

Vous recevrez une réponse comme celle-ci lorsque votre tâche de vérification en masse sera créée avec succès.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

Requête GET

Ce point de terminaison récupère les résultats d'une tâche de vérification d'e-mails en masse précédemment créée. Les résultats incluront l'état global de la tâche et, si la tâche est terminée, les résultats de la vérification des e-mails.

URL de Requête GET

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

Exemple de Réponse Réussie

Voici un exemple de réponse une fois votre tâche de vérification terminée :

Requête POST

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

Vérifications effectuées lors de la Vérification d'Emails en Masse

Validation Regex: Vérifie la structure des adresses e-mail selon les motifs regex standards de l'industrie pour détecter les fautes de frappe et les erreurs de format avant tout traitement supplémentaire.

Validation MX: Vérifie les enregistrements Mail Exchange (MX) valides pour confirmer que le domaine de l'e-mail est configuré pour recevoir des messages, garantissant son existence et son activité.

Validation de Liste Noire MX: Identifie les domaines figurant sur des listes noires connues pour spam ou activités malveillantes, vous aidant à éviter des destinations d'e-mail peu fiables ou dangereuses.

Validation SMTP: Effectue une vérification en temps réel en pingant le serveur SMTP du destinataire pour confirmer que l'adresse e-mail est active et capable de recevoir des e-mails.

Réponses d'Erreur

Message d'Erreur

Description

Clé API Invalide

Si la clé API est désactivée ou n'existe pas.

Requête Invalide

Si la requête contient des paramètres invalides.

0 crédits restants

Si l'utilisateur n'a pas de crédits disponibles.

Veuillez Réessayer

Lorsque quelque chose tourne mal de notre côté.

Vérifier le Solde du Compte

Veuillez utiliser la requête GET suivante pour vérifier le solde actuel du compte (crédits journaliers et instantanés restants).

URL de Requête GET (HTTPS) :

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Ici, remplacez le <Your_API_Key> par votre clé API active.

Réponse (JSON) :

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instructions pour le Single Email Finder

Introduction

L'API d'email unique vous permet de trouver une adresse e-mail professionnelle en temps réel en utilisant le nom d'une personne et le domaine de son entreprise. Elle est conçue pour des résultats rapides, précis et fiables, ce qui la rend idéale pour la génération de leads, l'enrichissement de contacts et les campagnes de prospection.

Ce point de terminaison vous permet de récupérer des adresses e-mail par requête en fournissant des informations telles que le nom et le nom de domaine. Le premier résultat trouvé correspondant à votre requête sera fourni en réponse. Chaque requête déduit dix crédits.

Authentification

Point de terminaison API

URL

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

Exemple de réponse si un email unique est trouvé

Vous recevrez une réponse identique si l'email est trouvé

Réponse si trouvé

{
  "email": "[email protected]",
  "status": "found"
}

Exemple de réponse si l'email n'est pas trouvé

Vous recevrez une réponse identique si l'email n'est pas trouvé

Réponse si non trouvé

{
  "email": "null",
  "status": "not_found"
}

Vérifications effectuées dans l'Email Finder

Vérification des combinaisons: Vérifiez le nom fourni contre vingt-cinq combinaisons avec le nom de domaine et identifiez laquelle aboutit à une adresse e-mail valide.

Validation MX: Vérifiez la présence de bons enregistrements Mail Exchange (MX) pour confirmer que le domaine e-mail est configuré pour recevoir des messages, garantissant son existence et son activité.

Validation de liste noire MX: Identifiez les domaines figurant sur des listes noires connues pour le spam ou les activités malveillantes, vous aidant à éviter des destinations e-mail non fiables ou dangereuses.

Validation SMTP: Effectuez une vérification en temps réel en contactant le serveur SMTP du destinataire pour confirmer que l'adresse e-mail est active et capable de recevoir des messages.

Réponses d'erreur

Message d'erreur

Description

Clé API invalide

Si la clé est désactivée ou n'existe pas

Requête invalide

Paramètres invalides dans le point de terminaison API

0 crédits restants

L'utilisateur n'a aucun crédit

Les domaines gratuits sont bloqués

Lorsque l'utilisateur tente de trouver l'email d'un domaine gratuit

Vérifier le solde du compte

Veuillez utiliser la requête GET suivante pour vérifier le solde actuel du compte (crédits quotidiens et instantanés restants).

URL de requête GET (HTTPS) :

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

Ici, remplacez <Your_API_Key> par votre clé API active.

Réponse (JSON) :

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}