Resumen
Has decidido dar el paso de implementar nuestra API de validación de emails. Un buen punto de partida es probar la API de validación de emails en el panel de control de Mailgun. De este modo, puedes enviar la validación rápida y fácilmente y ver la respuesta JSON de la API.
Si tu cuenta tiene acceso a ello, la opción de "Validations" (Validaciones) estará en el lado izquierdo de tu panel de control.
Descifrar las pistas
Una vez que se ha validado una dirección, ¿qué significa la respuesta? Echemos un vistazo a los parámetros de la respuesta JSON.
- address - Dirección que se está validando.
- did_you_mean - Una alternativa sugerida basada en errores ortográficos o tipográficos comunes.
- is_disposable_address - Devuelve "true" si el dominio es una dirección de correo electrónico desechable conocida.
- is_role_address - Devuelve "true" si la dirección está basada en una función, por ejemplo: asistencia@ejemplo.com o info@ejemplo.com.
- is_valid - Comprueba el email con la lista de reglas del proveedor conocido y devuelve "false" si se produce una infracción.
- mailbox_verification - Resultado de la validación del buzón con el ESP. No afecta a is_valid.
- parts - Segmentos analizados de la dirección de email.
- reason - Razón por la que la dirección no puede someterse a la validación de emails si corresponde.
Más ayuda para tu viaje
También tenemos SDK impulsados por la comunidad para los lenguajes de programación más populares para ayudarte a implementar la Validación de emails de Mailgun en tu proyecto.
Ya estás listo para comenzar a hacer llamadas de API y así validar direcciones de correo electrónico. Para ver todos los detalles técnicos sobre cómo implementar y hacer llamadas a la API de validación de emails, consulta nuestra documentación técnica aquí.
FAQ: Preguntas frecuentes
¿Cuál es la diferencia entre un punto de conexión de validaciones privado y uno público?
El punto de conexión público está pensado para utilizarse dentro de las aplicaciones del front-end (y solo está disponible para la versión 3 de la API de Validaciones). Para proteger la clave de la API pública, tiene un límite mensual inicial que se puede modificar. El punto de conexión privado está pensado para aplicaciones del back-end y no tiene esta limitación.
¿Cómo puedo limitar la cantidad de validaciones públicas que puede realizar mi cuenta?
Navega hasta "Account Settings" (Ajustes de la cuenta), donde puedes establecer el campo "Public Validation Limit" (Límite de validaciones públicas) como se muestra a continuación:
¿Cuál es la diferencia entre is_valid y mailbox_verification?
is_valid es el resultado de la comprobación de sintaxis específica del ESP, mientras que mailbox_verification hace una llamada al ESP para ver si el buzón existe de verdad.
¿Por qué mailbox_verification da "null" o valor cero?
La verificación del buzón está desactivada por defecto. Es necesario habilitarla en la llamada a la API pasando el parámetro "mailbox_verification=true".
Si mailbox_verification está deshabilitada, el resultado será "null"; "true", si la verificación del buzón es exitosa, y "false" si no lo es. También devolverá "unknown" si la sesión SMTP no pudo completarse o si el ESP no es compatible con la verificación del buzón.
¿Por qué is_valid da "true" y mailbox_verification, "false"?
Los resultados de la verificación del buzón no afectan a is_valid. Is_valid devuelve "true" si la dirección es analizable, pasa las comprobaciones de sintaxis conocidas y tiene un servidor SMTP válido, independientemente del resultado de la verificación del buzón.
¿Necesitas ayuda?
Nuestro equipo de asistencia en Sinch Mailgun estará encantado de ayudarte. Ponte en contacto con nosotros en la página de Asistencia de tu Panel de control de Mailgun y en breve estaremos contigo.