API de vérification d'e-mails pour les développeurs
Un seul endpoint REST. Vérifiez n'importe quelle adresse en moins de 100 ms. Hébergée dans l'UE, conforme au RGPD, avec des exemples pour Node, Python, PHP, Ruby et Go.
- Qu'est-ce qu'une API de vérification d'e-mails ?
- Une API de vérification d'e-mails est un point de terminaison HTTP qui indique si une adresse e-mail est réelle et délivrable avant que vous ne lui écriviez. Mailbeam effectue huit contrôles sur chaque adresse — syntaxe, enregistrements MX, existence SMTP, domaines jetables, adresses de rôle, fournisseurs gratuits, domaines catch-all et un score de qualité — et renvoie un verdict, un score sur 100 et un code de motif lisible par machine sur lequel votre application peut brancher.
Ce que Mailbeam contrôle
Chaque vérification lance 7 contrôles en parallèle et renvoie un résultat structuré en moins de 100 ms.
Réponse en moins de 100 ms
Vérifiez les e-mails en temps réel pendant l'inscription sans ajouter de latence perceptible au parcours de vos utilisateurs.
Vérification SMTP en direct
Nous nous connectons directement au serveur de messagerie et confirmons que la boîte existe, pas seulement que le domaine a des enregistrements MX.
Hébergée dans l'UE, le RGPD d'abord
Tout le traitement se fait sur une infrastructure européenne. Aucune conservation des données après la vérification. DPA disponible au titre de l'article 28.
Des exemples pour n'importe quelle stack
Node.js, Python, PHP, Ruby et Go. C'est un POST avec du JSON : une douzaine de lignes de votre client HTTP habituel et l'intégration est faite.
Détection des jetables et des adresses de rôle
Bloquez les adresses temporaires et les boîtes de service (info@, admin@) grâce à une base mise à jour en continu.
Suggestion sur les fautes de frappe
Quand quelqu'un tape « gmal.com », nous renvoyons « gmail.com » à l'instant pour qu'il corrige avant d'envoyer le formulaire.
Comment ça marche
Envoyez une requête POST
Envoyez l'adresse à /v1/verify avec votre clé API dans l'en-tête Authorization. C'est tout.
Requête DNS et enregistrements MX
Mailbeam interroge le DNS du domaine pour confirmer qu'il peut recevoir du courrier.
Poignée de main SMTP
Nous nous connectons au serveur de messagerie et simulons une tentative de livraison pour confirmer que cette boîte précise existe.
Résultat JSON structuré
Vous recevez un JSON avec le statut (deliverable/risky/undeliverable/unknown), un score de 0 à 100 et le verdict de chaque contrôle.
Intégrez-le en quelques minutes
curl -X POST https://api.mailbeam.dev/v1/verify \
-H "Authorization: Bearer $MAILBEAM_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "utilisateur@exemple.com"}'
# Réponse :
# {
# "email": "utilisateur@exemple.com",
# "status": "deliverable",
# "score": 97,
# "valid": true,
# "disposable": false,
# "role": false,
# "suggestion": null
# }Quand l'utiliser
Formulaires d'inscription
Validez au moment de l'inscription pour arrêter les e-mails faux ou mal saisis avant qu'ils n'entrent dans votre système.
Intégrations via l'API
Vérifiez les e-mails depuis n'importe quel backend : un POST avec un corps JSON, sans bibliothèque cliente obligatoire.
Webhooks et flux asynchrones
Envoyez une liste à l'endpoint batch et laissez un webhook signé batch.completed vous prévenir quand elle est prête, au lieu de faire du polling.
Enrichissement du CRM
Ajoutez le statut de vérification et le score à vos contacts pour alimenter le lead scoring et l'affectation commerciale.
Questions fréquentes
L'API est-elle rapide ?
Mailbeam répond en moins de 100 ms au 99e centile pour la plupart des domaines. La vérification SMTP de domaines inconnus peut atteindre 500 ms quand le serveur est lent à répondre.
Y a-t-il des SDK officiels ?
Pas encore : les bibliothèques officielles pour Node.js, Python, PHP, Ruby et Go sont dans la roadmap et l'API REST arrive en premier. C'est un seul POST avec un corps JSON, donc quelques lignes de votre client HTTP suffisent ; le guide de démarrage inclut un wrapper à copier pour chaque langage.
Existe-t-il une offre gratuite ?
Oui. L'offre gratuite inclut 1 000 vérifications par mois sans carte bancaire, de quoi intégrer et tester en production.
L'API conserve-t-elle les adresses e-mail ?
Pas en vérification temps réel : l'adresse est jetée dès que la réponse est renvoyée. L'exception, ce sont les traitements en masse, dont la liste et les résultats restent 72 heures pour vous laisser les télécharger, puis sont supprimés automatiquement. Mailbeam est conforme au RGPD et hébergée dans l'UE.
Quel SLA proposez-vous ?
Le SLA contractuel arrive avec les offres payantes. L'état en direct de chaque composant, contrôlé à chaque chargement de page, est sur mailbeam.dev/status.
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.