Glosario
Sintaxis de una dirección
La sintaxis establece cómo se forman la parte local, la arroba y el dominio de una dirección de correo. Un formato válido no confirma que existan el dominio o el buzón.
La comprobación de sintaxis determina si una entrada tiene un formato de dirección de correo admitido. En el ejemplo alex+orders@example.com, la parte local es alex+orders y el dominio es example.com. El analizador puede leer esa estructura sin consultar DNS ni abrir una conexión con un servidor de correo.
Puntos, signo más y formatos admitidos
En una parte local sin comillas, los puntos separan grupos de caracteres. No pueden aparecer al principio, al final ni dos seguidos: alex..orders@example.com tiene un formato incorrecto. El signo más sí está permitido. Conserve tanto el signo como la etiqueta que lo sigue al procesar la dirección. La guía de direcciones con signo más explica por qué no deben eliminarse.
RFC 5321 admite más formatos de los que acepta el analizador actual de Emvero para el registro. Este rechaza partes locales entre comillas, literales como user@[192.0.2.1], nombres para mostrar y listas de direcciones. Los motivos INVALID_SYNTAX, INVALID_LOCAL_PART e INVALID_DOMAIN identifican el error de entrada o la parte afectada. Un formato permitido por SMTP puede quedar fuera de las entradas admitidas por el producto.
Longitud y caracteres Unicode
Emvero admite hasta 64 octetos en la parte local y 254 en la dirección completa, una vez convertido el dominio a ASCII. Un octeto equivale a un byte; un carácter Unicode puede ocupar varios. Si la entrada supera esos límites, se devuelve ADDRESS_TOO_LONG. Son límites del servicio y no una afirmación sobre las restricciones de todos los servidores receptores.
Cuando la parte local contiene caracteres no ASCII, se necesita SMTPUTF8, según RFC 6531. Un dominio internacionalizado puede convertirse a ASCII, de modo que sus caracteres Unicode no requieren por sí solos esa extensión. La política actual de registro de Emvero admite partes locales internacionalizadas y registra la necesidad de la extensión en smtp_utf8_required.
El motivo SMTPUTF8_REQUIRED está definido para las políticas que no admiten esa entrada. No se devuelve por el mero hecho de aceptar una dirección internacionalizada. La explicación de las direcciones que el servicio no puede sondear describe qué ocurre si el servidor de destino no ofrece la extensión necesaria.
Qué confirma una comprobación de formato
Un error de sintaxis puede terminar la verificación con undeliverable y reject. Superar esta etapa confirma únicamente que la entrada tiene un formato admitido. El dominio puede no existir, su ruta de correo puede ser inutilizable o el buzón puede seguir sin confirmar. La comparación entre sintaxis y SMTP explica qué pueden aportar las siguientes comprobaciones. Conserve la parte local original al continuar el proceso.
Códigos de motivo relacionados
Los códigos de motivo identifican observaciones de la API y permiten definir condiciones como if en una integración. La explicación anterior aclara cuáles utiliza Emvero actualmente y qué significan.
INVALID_SYNTAX - La dirección no está bien formada
INVALID_LOCAL_ PART - La parte local no es válida
INVALID_DOMAIN - El dominio no es válido
ADDRESS_TOO_ LONG - La dirección supera la longitud permitida
SMTPUTF8_REQUIRED - Código definido para entradas internacionalizadas no admitidas; la política actual sí las admite