Mailbeam
API · SMTP

API de vérification SMTP

Sur la feuille de route : le sondage SMTP au niveau de la boîte n'est pas encore actif. Aujourd'hui, le verdict vient de la syntaxe, de MX/DNS, des listes d'adresses jetables et des adresses de rôle. Un enregistrement MX confirme que le domaine peut recevoir du courrier ; la vérification SMTP confirmera que la boîte précise existe.

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.

Poignée de main SMTP directe

Sur la feuille de route : Mailbeam se connectera au serveur cible et exécutera EHLO + MAIL FROM + RCPT TO pour tester si la boîte précise est acceptée — sans livrer de message. C'est le sondage que l'on appelle informellement un ping d'e-mail.

Gestion des MX multiples

Les domaines avec plusieurs enregistrements MX sont résolus aujourd'hui par ordre de priorité. Quand le sondage SMTP arrivera, un serveur principal muet fera basculer automatiquement sur les MX secondaires.

Le résultat SMTP dans la réponse

Le champ `smtp_check` fait déjà partie du contrat de la réponse. Tant que le sondage SMTP n'est pas là (il est sur la feuille de route), il ne confirme aucune boîte, et le verdict vient des autres contrôles.

Gestion propre des serveurs qui bloquent le sondage

Google, Microsoft et certains serveurs d'entreprise bloquent les sondages SMTP directs. Quand le sondage arrivera, un sondage bloqué renverra `status: unknown` plutôt qu'un faux négatif. Aujourd'hui, le verdict vient de la syntaxe, de MX/DNS, des listes d'adresses jetables et des adresses de rôle.

Distinct du contrôle MX seul

La validation MX confirme que le domaine a une infrastructure de messagerie et tourne aujourd'hui à chaque requête. La vérification SMTP de la boîte individuelle (la partie avant le @) est sur la feuille de route.

Exécution en parallèle des autres contrôles

Syntaxe, jetables et rôle ne coûtent presque rien, et la requête MX est en général en cache : les réponses sont rapides aujourd'hui. Quand le sondage SMTP arrivera (il est sur la feuille de route), ce sera la partie lente qui décidera du temps de réponse.

Comment ça marche

1

Récupération des enregistrements MX

Mailbeam résout les MX du domaine pour identifier le serveur responsable. Les enregistrements des domaines courants sont mis en cache pour réduire la latence DNS.

2

Ouverture de la connexion SMTP

Sur la feuille de route : une connexion TCP sera ouverte vers le serveur MX de plus haute priorité, sur le port 25 (ou 587 pour les serveurs de soumission uniquement), et Mailbeam enverra EHLO pour se présenter.

3

Envoi de la commande RCPT TO

Mailbeam enverra MAIL FROM avec une adresse de sondage et RCPT TO avec l'adresse cible. Le code de réponse du serveur (250 = accepté, 550 = rejeté) déterminera l'existence de la boîte.

4

Fermeture de la connexion, résultat renvoyé

Mailbeam enverra QUIT et fermera la connexion sans livrer le moindre e-mail. D'ici là, le résultat vient de la syntaxe, de MX/DNS, des listes d'adresses jetables et des adresses de rôle.

Intégrez-le en quelques minutes

PythonPython
import asyncio
import os
import httpx
# Pas encore de SDK — Mailbeam tient en un POST.
async def verify_email(email: str) -> dict:
    async with httpx.AsyncClient(timeout=3.0) as client:
        response = await client.post(
            "https://api.mailbeam.dev/v1/verify",
            json={"email": email},
            headers={"Authorization": f"Bearer {os.environ['MAILBEAM_KEY']}"},
        )
    response.raise_for_status()
    return response.json()
async def verify_with_smtp_detail(email: str) -> dict:
    result = await verify_email(email)
    print(f"Contrôle SMTP : {result['checks']['smtp']}")
    print(f"Contrôle MX :   {result['checks']['mx']}")
    print(f"Statut :        {result['status']}")
    print(f"Score :         {result['score']}")
    if result["status"] == "unknown":
        # Le sondage n'a pas pu trancher — Google et Microsoft ne sont jamais
        # sondés, et certains hôtes pratiquent le greylisting. On s'appuie sur le score.
        if result["score"] >= 60:
            return {"action": "allow", "reason": "domain_signals_positive"}
        return {"action": "review", "reason": "low_confidence_unknown"}
    if not result["valid"]:
        return {"action": "reject", "reason": result["reason"]}
    return {"action": "allow", "reason": "smtp_verified"}
# Utilisation
result = asyncio.run(verify_with_smtp_detail("user@company.com"))
print(result)

Quand l'utiliser

Validation de listes de prospection B2B

Avant d'envoyer une séquence à froid, vérifiez que le domaine de l'entreprise reçoit du courrier et que les contacts ne sont ni des adresses de rôle ni des jetables. La confirmation de la boîte par SMTP est sur la feuille de route.

Validation d'e-mails transactionnels critiques

Avant d'envoyer factures, contrats ou e-mails d'onboarding à de nouveaux comptes, vérifiez l'adresse pour attraper fautes de frappe, domaines morts et jetables. La vérification SMTP est sur la feuille de route.

Lever le doute sur un domaine catch-all

La détection catch-all dépend du sondage SMTP, qui est sur la feuille de route. Une fois en place, le résultat du sondage et un score plafonné donneront le verdict le plus utile pour une adresse d'entreprise sur un domaine catch-all.

Prévention des hard bounces à grande échelle

Pour des campagnes où la réputation d'expéditeur est un enjeu, vérifier à l'import élimine syntaxe cassée, domaines morts et jetables. Attraper les boîtes inexistantes demande le sondage SMTP, qui est sur la feuille de route.

Questions fréquentes

La vérification SMTP envoie-t-elle un vrai e-mail ?

Non. La poignée de main teste si le serveur accepterait le message, mais la connexion est fermée avant toute livraison. La boîte cible ne reçoit rien.

Pourquoi Google bloque-t-il le sondage SMTP ?

Les serveurs Gmail et Google Workspace répondent 250 (accepté) à toutes les commandes RCPT TO, que la boîte existe ou non — une contre-mesure délibérée contre la récolte d'adresses. Quand le sondage SMTP de Mailbeam arrivera (il est sur la feuille de route), ces adresses reviendront en `status: unknown` avec un score fondé sur les signaux du domaine.

Quelle différence entre smtp_check et le champ valid ?

`smtp_check` vous dira si la poignée de main a accepté l'adresse quand le sondage SMTP arrivera (il est sur la feuille de route) ; aujourd'hui, il ne confirme aucune boîte. `valid` est un booléen composite fondé sur la syntaxe, le MX, les jetables, le rôle et le score.

Tous les serveurs sont-ils joignables pour un sondage SMTP ?

Non. Certains bloquent complètement le port 25, exigent TLS ou empêchent le sondage. Le sondage SMTP de Mailbeam est sur la feuille de route ; aujourd'hui, tous les verdicts viennent de signaux de domaine : syntaxe, MX/DNS, listes d'adresses jetables et adresses de rôle.

Prêt à l'intégrer ?

Choisissez l'offre adaptée à votre volume. Chaque compte inclut des clés de test pour votre CI.