

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
<a name="email-validation-api"></a>

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
<a name="email-validation-api-console"></a>

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/](https://console.aws.amazon.com/ses/).

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

1. 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**.

1. 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
<a name="email-validation-api-cli"></a>

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 utilizar la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html)operació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 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html)datos 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).