API de vérification des enregistrements MX
Les enregistrements MX disent si un domaine possède une infrastructure de messagerie. Mailbeam le contrôle en première passe de chaque vérification et renvoie le résultat dans un seul appel.
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.
Une requête DNS MX par appel
Chaque appel verify effectue une requête MX en direct sur le domaine de l'adresse. Les résultats des domaines courants sont mis en cache pour réduire le coût des requêtes DNS.
Gestion des enregistrements MX multiples
Les domaines avec plusieurs MX (ordonnés par priorité) sont traités correctement. Mailbeam résout chaque hôte MX pour confirmer qu'il pointe vers une IP réelle.
Un booléen mx_check dans la réponse
Le champ `mx_check` vous dit précisément si le domaine a des enregistrements MX valides, indépendamment du résultat composite `valid`.
Détecte les MX absents, cassés ou mal configurés
Domaines sans MX, MX pointant vers des hôtes inexistants ou MX aux TTL mal configurés sont tous signalés comme échecs.
Un filtre de première passe rapide
Un échec MX signifie que tout le domaine ne peut pas recevoir de courrier — sonder en SMTP n'a aucun intérêt. Le contrôle MX court-circuite le pipeline et répond immédiatement pour les domaines sans infrastructure de messagerie.
Identification des domaines catch-all
Le contrôle MX alimente la détection catch-all. Si le MX passe et que le sondage SMTP accepte aussi une adresse aléatoire, le domaine est signalé catch-all et le score est plafonné.
Comment ça marche
Extraction du domaine
Mailbeam analyse l'adresse et en extrait le domaine (tout ce qui suit le @), en gérant les cas particuliers comme les sous-domaines et les domaines internationalisés.
Exécution de la requête DNS MX
Une requête DNS est envoyée au serveur de noms faisant autorité pour le domaine, pour obtenir les enregistrements MX. Les résultats sont mis en cache par domaine, avec une stratégie qui respecte le TTL.
Validation des enregistrements MX
Le nom d'hôte de chaque MX renvoyé est résolu pour confirmer qu'il pointe vers une adresse IP réelle. Les MX pointant vers des hôtes inexistants ou parqués sont traités comme des échecs.
Résultat renvoyé dans la réponse
Le booléen `mx_check` figure dans la réponse verify. Si le MX échoue, le `valid` global vaut false et le sondage SMTP est sauté — ce qui réduit la latence sur les domaines invalides.
Intégrez-le en quelques minutes
<?php
require_once __DIR__ . '/vendor/autoload.php';
use Mailbeam\Client;
$mb = new Client(['api_key' => getenv('MAILBEAM_KEY')]);
function verifyRegistrationEmail(string $email): array
{
$result = $mb->verify($email);
if (!$result->mx_check) {
return [
'valid' => false,
'message' => "Le domaine de l'adresse n'a pas d'enregistrement de serveur de messagerie.",
];
}
if (!$result->valid) {
$msg = "L'adresse e-mail n'a pas pu être vérifiée.";
if ($result->suggestion) {
$msg .= " Vouliez-vous dire {$result->suggestion} ?";
}
return ['valid' => false, 'message' => $msg];
}
return ['valid' => true, 'score' => $result->score];
}
// Utilisation dans un contrôleur Laravel
public function register(Request $request)
{
$check = verifyRegistrationEmail($request->input('email'));
if (!$check['valid']) {
return response()->json(['error' => $check['message']], 422);
}
// suite de l'inscription
}Quand l'utiliser
Filtrer les domaines d'entreprises disparues dans une liste B2B
Quand une entreprise ferme ou est rachetée, son domaine perd souvent ses enregistrements MX. Un contrôle MX repère vite ces domaines morts dans une liste B2B importée.
Préfiltrer de grandes listes avant le sondage SMTP
Si vous construisez votre propre pipeline de vérification et voulez n'utiliser Mailbeam que pour un préfiltrage au niveau DNS, le champ `mx_check` vous donne la validité du domaine avant tout travail SMTP.
Diagnostiquer des échecs de livraison
Quand vos e-mails vers un domaine rebondissent, utilisez le vérificateur MX gratuit ou l'API pour confirmer que la configuration du serveur de messagerie est correcte.
Valider un domaine à l'inscription
Si vous exigez une adresse professionnelle, un contrôle MX confirme que le domaine a une infrastructure de messagerie — un signal rapide qu'il s'agit d'une vraie entreprise et non d'un domaine inventé.
Questions fréquentes
Qu'est-ce qu'un enregistrement MX ?
Un enregistrement MX (Mail Exchange) est une entrée DNS qui désigne le serveur chargé d'accepter le courrier pour un domaine. Sans MX valide, un domaine ne peut pas recevoir d'e-mail — les messages rebondissent immédiatement.
Si le contrôle MX passe, l'adresse est-elle valide ?
Non. Un MX réussi signifie que le domaine a une infrastructure de messagerie. Savoir si la boîte précise (utilisateur@domaine) existe est un autre contrôle, qui demande une vérification SMTP. Le MX est nécessaire mais pas suffisant.
Le contrôle MX fonctionne-t-il pour tous les domaines ?
Oui. C'est une opération DNS standard qui fonctionne pour tout domaine enregistré publiquement. La seule exception concerne les domaines à DNS restreint ou privé, inaccessible depuis les résolveurs publics.
Pourquoi un contrôle MX échouerait-il sur un domaine qui semble actif ?
Causes courantes : le domaine vient de changer de fournisseur de messagerie et la propagation DNS est en cours ; le domaine utilise SPF mais a omis à tort ses enregistrements MX ; ou les hôtes MX sont temporairement injoignables. Mailbeam renvoie `mx_check: false` dans ces cas.
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.