API de validación de correo electrónico - Amazon Simple Email Service
Validación de API (consola)Validación de API (AWS CLI)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

API de validación de correo electrónico

La validación de la API le permite validar direcciones de correo electrónico individuales mediante llamadas a la API, lo que proporciona información inmediata sobre la validez de la dirección, la capacidad de entrega y los factores de riesgo. Esta función está diseñada para validar las direcciones en el punto de recopilación, por ejemplo, durante el registro del usuario, los formularios de suscripción o cualquier otro escenario en el que se necesiten resultados de validación a tiempo.

La validación de la API realiza varias comprobaciones en cada dirección de correo electrónico, incluidas la validación de la sintaxis, la verificación del dominio y las comprobaciones de existencia de los buzones, entre otras. Los resultados de la validación incluyen veredictos de confianza (ALTO, MEDIO o BAJO) para determinar la validez general y las evaluaciones individuales.

Comprobaciones de validación realizadas

La validación de la API realiza las siguientes evaluaciones en cada dirección de correo electrónico:

  • Validación de sintaxis (HasValidSyntax''): comprueba que la dirección de correo electrónico sigue los estándares RFC adecuados y contiene caracteres válidos en el formato correcto.

  • Registros DNS (HasValidDnsRecords''): comprueba que el dominio existe, tiene registros DNS válidos y está configurado para recibir correo electrónico.

  • Existencia del buzón (MailboxExists''): comprueba que el buzón existe y que puede recibir mensajes sin tener que enviar un correo electrónico.

  • Dirección de rol ('IsRoleAddress'): identifica las direcciones basadas en roles (como admin@, support@ o info@) que pueden tener tasas de participación más bajas.

  • Dominio desechable ('IsDisposable'): comprueba las direcciones de correo electrónico desechables o temporales que podrían afectar negativamente a la reputación de tu remitente.

  • Patrones de cadenas aleatorias (IsRandomInput''): comprueba los patrones generados aleatoriamente.

Uso de la validación de API con la consola Amazon SES

El siguiente procedimiento le muestra cómo validar una dirección de correo electrónico mediante la consola Amazon SES.

Para validar una dirección de correo electrónico mediante la consola Amazon SES

  1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en https://console.aws.amazon.com/ses/.

  2. En el panel de navegación izquierdo, selecciona Validación de direcciones de correo electrónico en Validación de correo electrónico.

  3. En la sección Validar dirección de correo electrónico, introduzca la dirección de correo electrónico que desee validar en el campo Dirección de correo electrónico.

  4. Elija Validar.

    Los resultados de la validación aparecen en el panel de resultados de la validación y muestran:

    • IsValid— Validez general con un veredicto de confianza (ALTO, MEDIO o BAJO).

    • Evaluaciones: los resultados de una evaluación individual incluyen veredictos de confianza en cuanto a la sintaxis, los registros de DNS, la existencia de los buzones y los factores de riesgo enumerados anteriormente.

Uso de la validación de la API con AWS CLI

En los siguientes ejemplos se muestra cómo validar las direcciones de correo electrónico mediante AWS CLI.

Para validar una dirección de correo electrónico mediante el AWS CLI

Puede usar la GetEmailAddressInsightsoperación en la API v2 de Amazon SES para validar las direcciones de correo electrónico. Puede llamar a esta operación desde AWS CLI, como se muestra en los siguientes ejemplos.

  • Valide una única dirección de correo electrónico:

    aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com

  • La respuesta tendrá un aspecto parecido al siguiente:

    {
    "MailboxValidation": {
        "IsValid": {
            "ConfidenceVerdict": "HIGH"
        },
        "Evaluations": {
            "HasValidSyntax": {
                "ConfidenceVerdict": "HIGH"
            },
            "HasValidDnsRecords": {
                "ConfidenceVerdict": "MEDIUM"
            },
            "MailboxExists": {
                "ConfidenceVerdict": "MEDIUM"
            },
            "IsRoleAddress": {
                "ConfidenceVerdict": "LOW"
            },
            "IsDisposable": {
                "ConfidenceVerdict": "LOW"
            },
            "IsRandomInput": {
                "ConfidenceVerdict": "LOW"
            }
        }
    }
}

  • Para obtener más información sobre los valores de respuesta y los tipos de datos, consulte el tipo de MailboxValidationdatos en la referencia de la API v2 de Amazon SES.

  • Asegúrese de que su identidad de IAM tenga los permisos necesarios para publicar CloudWatch métricas y llamadas a la API de validación de correo electrónico:

    {
  "Version": "2012-10-17		 	 	 ",
  "Statement": [
    {
      "Sid": "EmailValidationPermissions",
      "Effect": "Allow",
      "Action": [
        "ses:GetEmailAddressInsights",
        "iam:CreateServiceLinkedRole"
      ],
      "Resource": "*"
    }
  ]
}

    El GetEmailAddressInsights permiso es obligatorio para las llamadas de validación de la API y CreateServiceLinkedRole permite la publicación de CloudWatch métricas para la actividad de validación.

Interpretar los resultados de la validación

La respuesta de validación incluye veredictos de confianza para ayudarle a tomar decisiones sobre las direcciones de correo electrónico:

  • IsValid— Evaluación de la validez general con un veredicto de confianza alto, medio o bajo. Una confianza de validez alta indica una alta probabilidad de entrega de la dirección de correo electrónico, MEDIA indica una probabilidad de entrega moderada y BAJA indica una probabilidad de entrega baja.

  • Evaluations— Resultados de una evaluación individual, cada uno con un veredicto de confianza:

    • HIGH— Indicación clara de la comprobación específica (p. ej., ALTA IsRandomInput significa que es muy probable que el correo electrónico se genere de forma aleatoria).

    • MEDIUM— Indicación moderada de la verificación específica (por ejemplo, MEDIA IsRandomInput significa que existe alguna probabilidad de que la dirección de correo electrónico se genere de forma aleatoria).

    • LOW— Indicación débil o nula de la verificación específica (por ejemplo, baja IsRandomInput significa que es menos probable que la dirección de correo electrónico se genere de forma aleatoria).