Combien coûte une vérification API ?

Un POST /verify réussi utilise exactement 1 credit. Les requêtes GET (solde, historique) sont gratuites. Les crédits n'expirent pas — vous n'achetez que le nécessaire.

Puis-je vérifier le même email plusieurs fois ?

Oui. Chaque appel API /verify utilise 1 credit, même pour la même adresse. La facturation reste prévisible et alignée sur l'usage réel.

Comment générer une clé API ?

Créez un compte, ouvrez API tokens (/account/api), cliquez « New token » et copiez le secret ev_live_… ou ev_test_… (sandbox). La clé complète n'est affichée qu'une fois.

L'API prend-elle en charge la vérification bulk email ?

Oui. POST /bulk accepte jusqu'à 50 000 adresses. Coût : N crédits pour N emails. Suivez la progression via GET /bulk/:id et téléchargez les résultats CSV.

Que signifient valid, invalid et risky ?

valid — prêt à envoyer ; invalid — supprimer ; risky — disposable ou role account ; catch_all — le domaine accepte toutes les adresses. Voir la section Statuts.

Y a-t-il une limite de requêtes par minute ?

60 requêtes/min par clé API par défaut. La réponse 429 renvoie error: rate_limit_exceeded. Utilisez Idempotency-Key lors des retry POST /verify.

Où est la spécification OpenAPI complète ?

Téléchargez openapi-v1.yaml sur /api/v1/openapi.yaml ou Redoc interactif sur /fr/dokumentacja-api/reference.

Espace développeur · REST API v1

API de vérification d'adresses email

Vérifiez vos listes de diffusion par programmation — moins de rebonds, meilleure délivrabilité

Connectez formulaires d'inscription, CRM et landing pages à EmailVerifier. Vérifiez les adresses email via REST API en temps réel ou en jobs bulk — facturation transparente 1 request = 1 credit.

Vérification en temps réel
Bulk jusqu'à 50 000 emails
1 requête = 1 crédit

Générer une clé API Créer un compte OpenAPI / Redoc

Exemple de requête

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

Base de connaissances API

Choisissez un sujet — de l'authentification et des crédits aux jobs bulk, webhooks et codes d'erreur.

APIAPI de vérification email

POST /verify — une adresse, résultat en moins d'une seconde, statut valid/invalid/risky.

APIVérification bulk email

Vérification massive de listes CSV — file de jobs, polling de progression et export CSV.

APICrédits et facturation

Solde, usage API, 1 credit = 1 vérification, gestion HTTP 402.

APIClés API et auth

Bearer ev_live_, panneau de tokens, bonnes pratiques de stockage sécurisé.

APIWebhooks et intégrations

verification.completed, signature HMAC, CRM et marketing automation.

APIRéférence OpenAPI

Spécification YAML complète, UI Redoc et catalogue d'erreurs HTTP.

Qu'est-ce qu'une API de vérification email ?

Une interface REST pour valider les adresses avant vos campagnes.

Une API de vérification email contrôle si une adresse existe, si le domaine accepte le courrier et si la boîte est disposable ou catch-all. Vous réduisez le taux de rebond, protégez la réputation d'expéditeur et améliorez la délivrabilité.

L'API est servie en HTTPS sur /api/v1. Authentifiez-vous avec une clé Bearer (ev_live_…) ou une session dashboard. Chaque POST /verify réussi coûte un credit — sans abonnement ni frais cachés sur les GET.

Quand utiliser une API validateur email

Scénarios d'intégration courants dans les produits B2B et stacks marketing.

Formulaires d'inscription

Validez l'email en temps réel à l'inscription — rejetez invalid et disposable avant insertion en liste.

CRM et capture de leads

Nettoyez les leads des landing pages et webhooks — seules les adresses délivrables entrent dans le pipeline.

Hygiène de listes avant campagnes

Bulk API avant newsletter — moins de rebonds, taux d'ouverture plus élevé et coûts ESP réduits.

Plateformes SaaS

Intégrez les contrôles email dans votre produit — la facturation par crédits simplifie le pricing client.

Modèle de crédits API

Tarification simple : une requête de vérification = un credit.

POST /verify facture 1 credit par requête réussie (HTTP 200) avec clés ev_live_, même si la même adresse a déjà été vérifiée via API. Les clés sandbox (ev_test_) renvoient des mock sans débit.
Les opérations GET — solde, historique, statut bulk job, export CSV — sont gratuites.
Solde insuffisant renvoie HTTP 402 (insufficient_credits). Erreurs moteur (503) ne facturent pas de credit.

Authentification et clés API

Accès sécurisé via l'en-tête Authorization.

Connectez-vous au dashboard et ouvrez API tokens (/account/api).
Créez une clé production (ev_live_) ou sandbox (ev_test_) — le secret complet n'est affiché qu'une fois.
Envoyez la clé en Authorization: Bearer ev_live_… — jamais dans les URLs ou le code client.

Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Démarrage rapide — API vérification email

Deux appels : vérification du solde et première vérification.

1. Vérifier le solde de crédits

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Vérifier une adresse email

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Vérification unitaire (temps réel)

POST /api/v1/verify accepte du JSON avec un champ email. La réponse inclut status, score 0–100, provider (Google, Microsoft, hôtes régionaux) et enrichment (MX, catch-all).

POST /api/v1/verify

Structure de réponse JSON

Champs renvoyés après une vérification réussie.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

Statuts de vérification email

Classification utilisée dans l'API, le dashboard et les exports CSV.

valid

valid — l'adresse existe et peut recevoir du courrier ; sûr pour l'envoi.

invalid

invalid — l'adresse n'existe pas ou le domaine n'a pas de mail ; retirez de la liste.

risky

risky — faible confiance (ex. disposable, role account) ; prudence en campagne.

catch_all

catch_all — le serveur accepte toutes les adresses du domaine ; risque de rebond plus élevé.

unknown

unknown — réponse SMTP non concluante ; envisagez une re-vérification ultérieure.

Référence des endpoints REST

Liste complète des chemins API v1 avec coût en crédits.

Méthode	Chemin	Crédits	Détail
POST	/verify	1	Vérification email unitaire en temps réel
GET	/verify/:id	0	Récupérer le résultat par verificationId
GET	/verifications	0	Historique de vérifications et stats 30 jours
GET	/credits	0	Solde de crédits actuel du compte
POST	/bulk	N	Créer un job bulk (N crédits)
GET	/bulk/:id	0	Statut et progression du job bulk
GET	/bulk/:id/export	0	Télécharger les résultats en CSV
GET/POST/PATCH/DELETE	/api-keys	0	Gestion des tokens API (session)
GET/POST/DELETE	/webhooks	0	Configuration webhooks (session)
GET	/usage	0	Statistiques d'usage API et crédits

API de vérification email en masse

Vérifiez des milliers d'adresses en un job — idéal avant de grandes campagnes.

POST /bulk avec tableau emails ou texte CSV — crédits réservés pour N adresses uniques.
GET /bulk/:id — polling du statut (queued → processing → completed).
GET /bulk/:id/export — CSV avec colonnes email, status, score, provider.

curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Webhooks — événement verification.completed

Recevez un POST sur votre URL à la fin de la vérification. L'en-tête X-EV-Signature contient HMAC-SHA256 du body — vérifiez avant traitement.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Limites de débit

60 requêtes par minute par clé API par défaut. Dépassement renvoie HTTP 429 avec rate_limit_exceeded. Limites par clé — tokens séparés par intégration.

En-tête optionnel sur POST /verify — retries sûrs sans double débit de credit pour la même clé (TTL 24h).

X-Request-Id

Chaque réponse API inclut X-Request-Id — indiquez-le au support pour le débogage d'intégration.

Codes d'erreur HTTP

HTTP	Code	Détail
401	unauthorized	Session ou clé API manquante dans la requête.
401	invalid_api_key	Clé API invalide, expirée ou révoquée.
400	invalid_request	JSON invalide, champ email manquant ou adresse mal formée.
402	insufficient_credits	Crédits insuffisants — rechargez sur /account/credits.
429	rate_limit_exceeded	Limite de débit dépassée — 60 requêtes/min par clé API par défaut.
503	engine_unavailable	Moteur de vérification indisponible — aucun credit facturé.

Exemples d'intégration

Même flux de vérification dans les langages populaires.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — API vérification email

Questions fréquentes des développeurs et marketeurs.

OpenAPI 3.1 et Redoc

Spécification machine-readable pour codegen, tests de contrat et pipelines CI.

Télécharger openapi-v1.yaml Référence Redoc interactive

Commencez à vérifier des emails via API

Crédits d'essai gratuits à l'inscription. Clé API dans votre dashboard en une minute.

Créer un compte Jetons API

Générez votre clé dans le panneau de compte.