Mailbeam
API · Correction

API de correction des fautes de frappe

Un seul domaine mal tapé, et c'est une inscription qui ne s'active jamais. Renvoyez une suggestion « vouliez-vous dire » instantanée pour que l'utilisateur corrige d'un geste.

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.

Suggestions de domaine dans la réponse

Quand le domaine est à un cheveu d'un fournisseur connu (gmal.com, yaho.com, hotmial.com), la réponse contient un champ de suggestion corrigée.

Correspondance par distance d'édition

Les suggestions s'appuient sur la proximité avec un large ensemble d'orthographes de boîtes et de TLD courants, pas sur une petite liste en dur : les fautes rares sont attrapées aussi.

Réparation du TLD

Corrige les domaines de premier niveau tronqués ou erronés — gmail.co et gmail.cm mènent tous deux à une suggestion gmail.com.

Préserve la partie locale

Seul le domaine est corrigé ; jane.doe reste jane.doe, si bien que la suggestion peut être acceptée telle quelle en toute sécurité.

Une correction en un geste

Affichez la suggestion comme une invite cliquable, pour que l'utilisateur corrige sans retaper toute l'adresse.

Prudente par conception

Les suggestions ne se déclenchent que sur des quasi-correspondances à forte confiance : un domaine valide mais peu courant n'est jamais remis en question.

Comment ça marche

1

POSTez l'adresse saisie

Envoyez l'adresse brute à /v1/verify à la validation — ou à la perte de focus, pour une correction en ligne.

2

Comparaison aux fournisseurs connus

Le domaine est mesuré contre un large corpus de fournisseurs et de TLD courants, par distance d'édition.

3

Une correspondance à forte confiance donne une suggestion

S'il existe une correspondance proche et non ambiguë, la réponse porte suggestion: 'jane.doe@gmail.com'.

4

Vous invitez l'utilisateur

Affichez « Vouliez-vous dire jane.doe@gmail.com ? » et laissez-le accepter d'un geste avant la création du compte.

Intégrez-le en quelques minutes

Proposer une correctiontypescript
const res = await fetch("https://api.mailbeam.dev/v1/verify", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` },
  body: JSON.stringify({ email }),
});
const { suggestion } = await res.json();
if (suggestion) {
  // ex. suggestion = "jane.doe@gmail.com"
  showPrompt(`Vouliez-vous dire ${suggestion} ?`, { onAccept: () => setEmail(suggestion) });
}

Quand l'utiliser

Formulaires d'inscription

Le moment où une faute de frappe fait le plus de dégâts — une mauvaise adresse ici casse l'activation et tous les e-mails suivants.

Champ e-mail du tunnel d'achat

Récupérez la confirmation de commande qui rebondirait sinon à cause d'une touche à côté.

Capture de leads

Cessez de perdre des leads qualifiés à cause d'un domaine mal tapé sur un formulaire.

Changement d'adresse du compte

Confirmez que la nouvelle adresse est bien celle que l'utilisateur voulait avant de basculer ses notifications.

Questions fréquentes

Comment la suggestion est-elle générée ?

Le domaine est comparé à un large ensemble d'orthographes de fournisseurs et de TLD courants, par distance d'édition. Quand une correspondance proche et unique à forte confiance existe, l'adresse corrigée est renvoyée dans le champ suggestion.

Va-t-elle « corriger » à tort un domaine d'entreprise valide ?

Non. Les suggestions ne se déclenchent que sur des quasi-correspondances à forte confiance de fournisseurs bien connus. Un domaine professionnel valide mais peu courant ne déclenche rien, parce qu'il n'est proche de rien de connu.

Modifie-t-elle la partie avant le @ ?

Non. Seul le domaine est corrigé. La partie locale est préservée à l'identique : accepter une suggestion est donc toujours sans risque.

Peut-elle corriger un TLD erroné comme .cm ou .co ?

Oui. Les TLD tronqués ou mal tapés comme gmail.co, gmail.cm et gmail.con mènent tous à une suggestion gmail.com.

Dois-je appliquer la suggestion automatiquement ?

Non — et mieux vaut s'en abstenir. Présentez-la comme une invite que l'utilisateur confirme. L'appliquer d'office risquerait d'écraser une adresse qu'il voulait vraiment.

Prêt à l'intégrer ?

L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.