API de validación de sintaxis de email
Una expresión regular en el navegador caza los errores evidentes. La validación RFC 5322 en el servidor caza los casos límite, y no se puede esquivar.
Qué comprueba Mailbeam
Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.
Análisis conforme al RFC 5322
Mailbeam valida la sintaxis del email contra el estándar RFC 5322. Eso incluye partes locales entrecomilladas, caracteres internacionalizados y formatos poco comunes pero válidos que la mayoría de expresiones regulares rechaza por error.
Normalización del email
La respuesta incluye un campo `normalized_email`: dominio en minúsculas, espacios recortados y formato consistente. Guarda la versión normalizada para evitar cuentas duplicadas con la misma dirección.
Sugerencia de errata
Los errores de dominio más comunes (gmal.com, hotmal.com, outlok.com) se detectan y se devuelve una sugerencia corregida. Muéstrala en tu interfaz antes de que el usuario envíe el formulario.
Booleano syntax_check
El booleano `syntax_check` de la respuesta aísla el resultado de sintaxis del compuesto `valid`. Úsalo para distinguir un fallo de sintaxis de uno de MX o SMTP en tu manejo de errores.
Fallo inmediato ante sintaxis inválida
Cuando la validación de sintaxis falla, Mailbeam devuelve el resultado al momento: no se hace ninguna llamada DNS ni SMTP. Eso convierte el fallo de sintaxis en la respuesta más rápida posible, por debajo de 5 ms.
Aplicación en servidor que no se puede esquivar
La validación en el navegador se desactiva apagando JavaScript o usando las herramientas de desarrollo. La validación de sintaxis en servidor mediante API garantiza que toda dirección guardada en tu base de datos cumple el RFC.
Cómo funciona
Se analiza la cadena del email
El email se divide en parte local (antes de la arroba) y dominio (después). Cada parte se valida de forma independiente contra las reglas del RFC 5322.
Se ejecuta la detección de erratas
El dominio se compara con un diccionario de dominios de correo legítimos habituales. Si existe una corrección de alta probabilidad (distancia de edición de 2 o menos), se genera una sugerencia.
Se aplica la normalización
El dominio se pasa a minúsculas, se recortan los espacios y se devuelve la cadena normalizada en la respuesta. Las etiquetas del signo más se conservan (no se eliminan) en la normalización.
Retorno temprano o cadena completa
Si la sintaxis falla, Mailbeam devuelve el resultado de inmediato con `syntax_check: false`. Si pasa, el resto de comprobaciones (MX, SMTP, desechables, etc.) siguen en paralelo.
Intégralo en minutos
import java.net.http.*;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
@Service
public class EmailValidationService {
private final HttpClient http = HttpClient.newHttpClient();
private final ObjectMapper mapper = new ObjectMapper();
private final String apiKey = System.getenv("MAILBEAM_KEY");
public ValidationResult validate(String email) throws Exception {
String body = mapper.writeValueAsString(Map.of("email", email));
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://api.mailbeam.dev/v1/verify"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> resp = http.send(req, HttpResponse.BodyHandlers.ofString());
JsonNode result = mapper.readTree(resp.body());
if (!result.get("syntax_check").asBoolean()) {
String suggestion = result.has("suggestion") && !result.get("suggestion").isNull()
? result.get("suggestion").asText() : null;
throw new InvalidEmailException("Formato de email no válido.", suggestion);
}
return new ValidationResult(
result.get("valid").asBoolean(),
result.get("score").asInt(),
result.get("normalized_email").asText()
);
}
}Cuándo usarlo
Validación de entrada en API de servidor
En arquitecturas de microservicios, valida los campos de email en cada frontera de API. Una comprobación de sintaxis en la puerta de enlace impide que los datos mal formados se propaguen por tu sistema.
Saneamiento de importaciones a base de datos
Al importar datos de email de fuentes externas (CSV, sistemas heredados, herramientas de terceros), una comprobación de sintaxis identifica las entradas mal formadas antes de que entren en tu base de datos.
Refuerzo del formulario de registro
Combina una validación ligera en el navegador para la experiencia de usuario con la aplicación autoritativa en el servidor. La comprobación del servidor caza lo que se le escapa al cliente y no se puede esquivar.
Auditorías de calidad de datos
En bases de datos con datos de email históricos, lanza una comprobación de sintaxis por lotes para identificar y marcar los registros que no cumplen el RFC 5322: suele ser un requisito previo para el cumplimiento de calidad de datos del RGPD.
Preguntas frecuentes
¿Listo para integrarlo?
El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.