¿Cómo se genera la sugerencia?

El dominio se compara con un conjunto amplio de grafías de proveedores y dominios de primer nivel habituales mediante distancia de edición. Cuando hay una única coincidencia cercana y de alta confianza, se devuelve esa dirección corregida en el campo suggestion.

¿Puede «corregir» por error un dominio de empresa válido?

No. Las sugerencias solo se disparan ante casi-aciertos de alta confianza sobre proveedores muy conocidos. Un dominio corporativo válido pero poco común no dispara ninguna sugerencia, porque no se queda a un paso de nada conocido.

¿Cambia la parte anterior a la arroba?

No. Solo se corrige el dominio. La parte local se conserva exactamente igual, así que aceptar una sugerencia siempre es seguro.

¿Arregla dominios de primer nivel erróneos como .cm o .co?

Sí. Los dominios truncados o mal escritos como gmail.co, gmail.cm y gmail.con devuelven todos una sugerencia de gmail.com.

¿Tengo que aplicar la sugerencia automáticamente?

No, y no deberías. Preséntala como un aviso que el usuario confirma. Aplicarla sola arriesga sobrescribir una dirección que el usuario quería de verdad.

API · Corrección

API de corrección de erratas en emails

Un solo dominio mal escrito es un registro que nunca se activa. Devuelve al instante una sugerencia de «¿quisiste decir...?» para que el usuario lo corrija de un toque.

Prueba la corrección de erratas gratis, sin API key Consigue acceso gratis a la API

Qué comprueba Mailbeam

Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.

Sugerencias de dominio en la respuesta

Cuando el dominio se queda a un paso de un proveedor conocido (gmal.com, yaho.com, hotmial.com), la respuesta incluye un campo con la sugerencia corregida.

Comparación por distancia de edición

Las sugerencias se basan en la proximidad a un conjunto amplio de grafías comunes de buzones y dominios de primer nivel, no en una lista corta escrita a mano, así que también se cazan las erratas menos frecuentes.

Reparación del dominio de primer nivel

Corrige los dominios de primer nivel truncados o equivocados: gmail.co y gmail.cm devuelven ambos una sugerencia de gmail.com.

Conserva la parte local

Solo se corrige el dominio; jane.doe sigue siendo jane.doe, así que la sugerencia se puede aceptar tal cual sin riesgo.

Corrección de un toque

Muestra la sugerencia como un aviso pulsable para que el usuario arregle la dirección sin volver a escribirla entera.

Conservadora por diseño

Las sugerencias solo se disparan ante casi-aciertos de alta confianza, así que nunca se pone en duda un dominio válido poco común.

Cómo funciona

Haz POST de la dirección escrita

Envía la dirección tal cual a /v1/verify cuando el usuario envíe el formulario, o al perder el foco el campo para corregir en línea.

Se compara el dominio con proveedores conocidos

El dominio se contrasta con un corpus amplio de proveedores y dominios de primer nivel habituales usando distancia de edición.

Un acierto de alta confianza devuelve una sugerencia

Si existe una coincidencia cercana e inequívoca, la respuesta lleva suggestion: 'jane.doe@gmail.com'.

Tú se lo propones al usuario

Muestra «¿Quisiste decir jane.doe@gmail.com?» y deja que lo acepte de un toque antes de crear la cuenta.

Intégralo en minutos

Sugerir una correccióntypescript

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) {
  // p. ej. suggestion = "jane.doe@gmail.com"
  showPrompt(`¿Quisiste decir ${suggestion}?`, { onAccept: () => setEmail(suggestion) });
}

Guía de inicio rápido →Referencia de la API