Mailbeam
API · Domaine

API de vérification de domaine

Vérifiez le côté domaine d'une adresse : le domaine est-il actif, est-ce un fournisseur gratuit, un domaine d'entreprise, ou un catch-all ? Le tout en 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.

Détection des fournisseurs gratuits

L'indicateur `free_provider` identifie les adresses Gmail, Yahoo, Outlook et autres fournisseurs grand public. Servez-vous-en pour exiger une adresse professionnelle sur un produit B2B.

Indicateur de domaine catch-all

Le champ `catch_all` fait partie du contrat de la réponse. Détecter les domaines catch-all demande le sondage SMTP, qui est sur la feuille de route ; une fois en place, il signalera les serveurs qui acceptent toutes les adresses et plafonnera le score.

Détection des domaines jetables

L'indicateur `disposable` attrape les services éphémères au niveau du domaine. Une adresse jetable est toujours rejetée, quelle que soit la réponse SMTP.

Validation des enregistrements MX

Le booléen `mx_check` confirme que le domaine dispose d'une infrastructure de messagerie active. Domaines d'entreprises disparues, domaines parqués et domaines expirés échouent à ce contrôle.

Contribution du domaine au score

Les signaux de réputation du domaine — ancienneté, historique MX, présence dans les registres d'entreprises connus — alimentent le score global. Le sondage SMTP est sur la feuille de route : aujourd'hui, ce sont les signaux de domaine qui portent le score.

Un seul appel, tous les champs de domaine

Tous les contrôles au niveau du domaine tournent dans l'endpoint verify standard. Pas d'endpoint dédié au domaine — le résultat complet porte les contrôles de domaine et d'adresse. Le sondage SMTP de la boîte est sur la feuille de route.

Comment ça marche

1

Extraction du domaine

La partie domaine de l'adresse est analysée et normalisée pour tous les contrôles suivants.

2

Classification du fournisseur

Le domaine est comparé à la liste des fournisseurs gratuits, à la base des domaines jetables et aux signaux de registres de domaines d'entreprise connus.

3

Contrôle MX et catch-all

La requête DNS MX confirme que le domaine a une infrastructure de messagerie. La détection catch-all par sondage SMTP est sur la feuille de route.

4

Champs de domaine renvoyés

La réponse contient `free_provider`, `disposable`, `catch_all`, `mx_check` et le `score` influencé par le domaine — prêts pour la logique de votre application.

Intégrez-le en quelques minutes

Node.jsJavaScript
// Pas encore de SDK — le wrapper de 12 lignes de /docs/quickstart.
import { verifyEmail } from "@/lib/mailbeam";
// Exiger une adresse professionnelle dans le flux d'invitation d'un produit B2B
export async function validateTeamMemberEmail(email, allowedDomain) {
  const result = await verifyEmail(email);
  if (!result.mx_check) {
    return { ok: false, error: "Le domaine de l'adresse n'a pas de serveur de messagerie actif." };
  }
  if (result.disposable) {
    return { ok: false, error: "Les adresses e-mail temporaires ne sont pas autorisées." };
  }
  if (result.free_provider) {
    return {
      ok: false,
      error: `Utilisez votre adresse professionnelle ${allowedDomain} pour rejoindre cet espace.`,
    };
  }
  // Facultatif : imposer un domaine précis pour les offres d'équipe
  const domain = email.split("@")[1].toLowerCase();
  if (allowedDomain && domain !== allowedDomain) {
    return {
      ok: false,
      error: `Seules les adresses @${allowedDomain} peuvent rejoindre cet espace.`,
    };
  }
  return { ok: true, score: result.score };
}

Quand l'utiliser

Exiger une adresse professionnelle sur un produit B2B

Servez-vous de `free_provider: true` pour bloquer Gmail, Yahoo et Outlook sur les offres entreprise. Exigez un domaine d'entreprise pour les invitations d'équipe ou la création d'espaces de travail.

Qualifier les leads par type de domaine

Notez différemment les leads entrants selon le domaine : domaine d'entreprise (forte valeur), fournisseur gratuit (moyenne), catch-all à score élevé (à inclure), catch-all à score faible (à écarter).

Détecter les domaines d'entreprises disparues

Quand une entreprise cesse son activité ou est rachetée, son domaine perd souvent ses MX. Un échec MX au niveau du domaine est un signal fiable d'adresse professionnelle non fonctionnelle.

Liste de domaines autorisés pour les offres d'équipe

Combinez les contrôles MX et catch-all de Mailbeam avec votre propre liste autorisée, pour garantir que tous les membres d'un espace de travail s'inscrivent avec le même domaine d'entreprise.

Questions fréquentes

Puis-je bloquer toutes les inscriptions Gmail et Yahoo avec Mailbeam ?

Oui. L'indicateur `free_provider` identifie les fournisseurs grand public. Contrôlez-le dans votre gestionnaire d'inscription et renvoyez une erreur exigeant une adresse d'entreprise. À noter : bloquer les fournisseurs gratuits est rarement pertinent partout — cela a du sens en B2B, pas dans une application grand public.

Comment distinguer une vraie entreprise d'un faux domaine ?

Combinez `mx_check` (le domaine a une infrastructure), `disposable: false` (pas un service éphémère connu) et `score` (signaux de réputation). Un domaine d'entreprise positif sur les trois est un signal fort d'adresse professionnelle légitime.

Existe-t-il un endpoint dédié au domaine seul ?

Non. Tous les contrôles de domaine (MX, fournisseur gratuit, jetable) sont renvoyés dans la réponse `/v1/verify` standard, avec les contrôles de l'adresse. Le sondage SMTP au niveau de la boîte est sur la feuille de route.

Qu'est-ce qui compte comme « fournisseur gratuit » ?

Les fournisseurs gratuits sont les services grand public qui offrent des adresses sans frais : Gmail, Yahoo, Outlook/Hotmail, iCloud, AOL, Protonmail et une cinquantaine d'autres grands fournisseurs. Les domaines personnalisés Google Workspace et Microsoft 365 ne sont PAS signalés comme fournisseurs gratuits.

Prêt à l'intégrer ?

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