Quickstart
Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.
Démarrez avec l'API EmailVerify en seulement 5 minutes. Ce guide vous accompagne dans la vérification de votre première adresse email.
Prérequis
Avant de commencer, vous aurez besoin de :
- Un compte EmailVerify (Inscription gratuite)
- Connaissances de base des requêtes HTTP ou familiarité avec l'un de nos langages supportés
Étape 1 : Créer un Compte
- Visitez EmailVerify et cliquez sur Commencer
- Inscrivez-vous avec votre email ou compte Google/GitHub
- Vérifiez votre adresse email
Étape 2 : Obtenir Votre Clé API
- Connectez-vous à votre tableau de bord EmailVerify
- Accédez à la section Clés API
- Cliquez sur Créer une Nouvelle Clé
- Donnez à votre clé un nom descriptif (par ex., "Développement", "Production")
- Copiez votre clé API et stockez-la en toute sécurité
N'exposez jamais votre clé API dans du code côté client ou des dépôts publics. Utilisez des variables d'environnement pour stocker votre clé en toute sécurité.
Étape 3 : Vérifier Votre Premier Email
Choisissez votre méthode préférée pour effectuer votre première requête de vérification :
curl -X POST https://api.emailverify.ai/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'const response = await fetch('https://api.emailverify.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'test@example.com',
}),
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
'https://api.emailverify.ai/v1/verify',
headers={
'Authorization': f'Bearer {os.environ["EMAILVERIFY_API_KEY"]}',
'Content-Type': 'application/json',
},
json={'email': 'test@example.com'}
)
result = response.json()
print(result)package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
data := map[string]string{"email": "test@example.com"}
body, _ := json.Marshal(data)
req, _ := http.NewRequest("POST",
"https://api.emailverify.ai/v1/verify",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("EMAILVERIFY_API_KEY"))
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}<?php
$apiKey = getenv('EMAILVERIFY_API_KEY');
$ch = curl_init('https://api.emailverify.ai/v1/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);Étape 4 : Comprendre la Réponse
Une vérification réussie renvoie une réponse comme celle-ci :
{
"email": "test@example.com",
"status": "valid",
"result": {
"deliverable": true,
"valid_format": true,
"valid_domain": true,
"valid_mx": true,
"disposable": false,
"role": false,
"catchall": false,
"free": false,
"smtp_valid": true
},
"score": 0.95,
"credits_used": 1
}Champs de Réponse Clés
| Champ | Type | Description |
|---|---|---|
status | string | Statut global : valid, invalid, unknown, ou accept_all |
deliverable | boolean | Indique si l'email peut recevoir des messages |
disposable | boolean | Indique s'il s'agit d'un email temporaire/jetable |
role | boolean | Indique s'il s'agit d'une adresse de rôle (info@, support@) |
catchall | boolean | Indique si le domaine accepte tous les emails |
score | number | Score de confiance de 0 à 1 (plus élevé est meilleur) |
Explication des Valeurs de Statut
| Statut | Signification | Action Recommandée |
|---|---|---|
valid | L'email existe et peut recevoir des messages | Envoi sécurisé |
invalid | L'email n'existe pas ou ne peut pas recevoir de messages | Retirer de la liste |
unknown | Impossible de déterminer le statut | Réessayer plus tard ou utiliser avec prudence |
accept_all | Le domaine accepte tous les emails (catch-all) | Surveiller les rebonds |
Étape 5 : Utiliser un SDK (Recommandé)
Pour une intégration plus facile, installez l'un de nos SDK officiels :
npm install @emailverify/nodeimport { EmailVerify } from '@emailverify/node';
const client = new EmailVerify({
apiKey: process.env.EMAILVERIFY_API_KEY,
});
const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'pip install emailverifyfrom emailverify import Client
import os
client = Client(api_key=os.environ['EMAILVERIFY_API_KEY'])
result = client.verify('test@example.com')
print(result.status) # 'valid'go get github.com/emailverify/go-sdkimport emailverify "github.com/emailverify/go-sdk"
client := emailverify.NewClient(os.Getenv("EMAILVERIFY_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"composer require emailverify/php-sdkuse EmailVerify\Client;
$client = new Client(getenv('EMAILVERIFY_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'<dependency>
<groupId>com.emailverify</groupId>
<artifactId>emailverify-java</artifactId>
<version>1.0.0</version>
</dependency>import com.emailverify.Client;
Client client = new Client(System.getenv("EMAILVERIFY_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"Et Ensuite ?
Maintenant que vous avez vérifié votre premier email, explorez plus de fonctionnalités :
Référence API
Documentation API complète avec tous les points de terminaison
Documentation SDK
Guides détaillés pour chaque SDK
Types de Vérification
Comprendre les différents types de résultats
Intégration AI
Utiliser avec Claude, ChatGPT, et plus
Cas d'Utilisation Courants
Validation de Formulaire
Vérifiez les emails en temps réel lors de l'inscription des utilisateurs :
const onEmailBlur = async (email) => {
const result = await client.verify(email);
if (result.status === 'invalid') {
showError('Veuillez saisir un email valide');
} else if (result.result.disposable) {
showError('Les emails jetables ne sont pas autorisés');
}
};Nettoyage de Liste
Nettoyez votre liste d'emails avant d'envoyer des campagnes :
for email in email_list:
result = client.verify(email)
if result.status == 'valid':
clean_list.append(email)
else:
remove_list.append(email)Qualification de Prospects
Notez les prospects en fonction de la qualité de l'email :
const qualifyLead = (verificationResult) => {
let score = verificationResult.score * 50; // Score de base
if (!verificationResult.result.free) score += 20; // Email professionnel
if (!verificationResult.result.role) score += 15; // Adresse personnelle
if (!verificationResult.result.disposable) score += 15; // Email permanent
return score;
};Besoin d'Aide ?
- Parcourez nos Guides d'Intégration pour des exemples d'implémentation
- Contactez support@emailverify.ai pour assistance