Documentation API — VerifyEmail

Démarrage rapide

Créez une clé API dans le tableau de bord, conservez-la sur votre serveur et envoyez-la comme identifiant Bearer. Chaque demande de vérification acceptée consomme un crédit.

Requête

curl -sS -X POST 'https://api.verifyemail.net/api/v1/verifications' \
  -H 'Authorization: Bearer ve_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"address":"[email protected]"}'

Réponse · HTTP 200

{
  "errcode": 0,
  "address": "[email protected]",
  "is_deliverable": true,
  "status": 250,
  "catch_all": false,
  "disposable": false
}

Authentification

Créez une clé API dans votre tableau de bord : Tableau de bord → Clés API

La valeur complète ve_live_… n’est affichée qu’une seule fois.

Conservez les clés API dans les secrets du serveur. Ne les placez jamais dans le code du navigateur, les paramètres d’URL, les dépôts publics ou les journaux visibles côté client.

Authorization: Bearer ve_live_your_api_key

Vérifier un e-mail

POST/verifications

Corps de la requête

Champ	Type	Obligatoire	Description
address	string	Oui	Une adresse e-mail complète.

Champs de réponse

Champ	Type	Description
errcode	number	0 indique une réussite ; traitez les autres valeurs avec le tableau des erreurs.
address	string	L’adresse e-mail normalisée.
is_deliverable	boolean	Indique si le serveur destinataire accepte le destinataire.
status	number \| null	Le code numérique de réponse SMTP, ou null si aucune réponse SMTP n’a été reçue.
catch_all	boolean \| null	Indique si le domaine accepte tous les destinataires. Null signifie qu’aucune conclusion fiable n’est possible.
disposable	boolean	Indique si l’adresse appartient à un domaine d’e-mail jetable.

250 · HTTP 200 · errcode 0

Le serveur destinataire a accepté le destinataire.

550 · HTTP 200 · errcode 0

Le domaine ou le serveur destinataire a refusé le destinataire.

null · HTTP 422

L’adresse est invalide ou ne peut pas être vérifiée.

null · HTTP 503

Aucune conclusion fiable n’est disponible ; réessayez plus tard.

Le point de terminaison GET ci-dessous est également disponible. POST est recommandé afin d’éviter que les adresses apparaissent dans les journaux du proxy ou l’historique du navigateur : /verifications?address=…

Consulter les crédits restants

GET/usage

Cette requête ne consomme aucun crédit de vérification. Les sessions du tableau de bord et toutes les clés API d’un même utilisateur partagent le même quota.

Requête

curl -sS 'https://api.verifyemail.net/api/v1/usage' \
  -H 'Authorization: Bearer ve_live_your_api_key'

Réponse · HTTP 200

{
  "errcode": 0,
  "verification_limit": 100,
  "verification_used": 1,
  "remaining_verifications": 99,
  "unlimited": false
}

Champ	Type	Description
verification_limit	number	Le quota total actuel. Zéro signifie illimité.
verification_used	number	Le nombre de crédits de vérification déjà utilisés.
remaining_verifications	number \| null	Les crédits encore disponibles ; null pour un compte illimité.
unlimited	boolean	Indique si le quota actuel est illimité.

Les offres illimitées renvoient remaining_verifications: null, unlimited: true.

Codes d’erreur

Utilisez le nombre errcode dans la logique du programme. Le texte message peut évoluer.

Réponse d’erreur

{
  "errcode": 10006,
  "message": "request rate limit exceeded"
}

errcode	HTTP	Signification
0	2xx	Requête réussie.
10000	400	Requête mal formée ; vérifiez le JSON, les en-têtes et la méthode HTTP.
10001	400 / 422	Un paramètre ou une règle métier a échoué à la validation.
10002	401	L’identifiant est absent, invalide ou expiré.
10003	403	Le compte ne peut pas accéder à cette ressource.
10004	404	La ressource demandée n’existe pas.
10005	409	La ressource est en conflit avec son état actuel.
10006	429	La limite de requêtes par seconde est dépassée.
10007	429	Les crédits de vérification sont épuisés.
10008	429	La capacité de concurrence du service est épuisée.
10009	500	Une erreur interne du service s’est produite.
10010	503	Le service est temporairement indisponible ou non configuré.
10011	502	Un service en amont a renvoyé une erreur.

En-têtes de limitation

Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset — décrivent la fenêtre de requêtes actuelle.

Prêt à envoyer votre première requête ?Créez un compte et obtenez 100 crédits de vérification.