本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 电子邮件验证 API
<a name="email-validation-api"></a>

API 验证允许您通过 API 调用验证各个电子邮件地址，提供有关地址有效性、送达率和风险因素的即时反馈。此功能专为在收集时验证地址而设计，例如在用户注册、订阅表单或任何其他需要及时验证结果的场景中。

API 验证对每个电子邮件地址执行多项检查，包括语法验证、域名验证、邮箱存在检查等。验证结果包括总体有效性的置信度判定（高、中或低）和个人评估。

**已执行验证检查**  
API 验证对每个电子邮件地址执行以下评估：
+ **语法验证 (HasValidSyntax'')**-检查电子邮件地址是否符合正确的 RFC 标准并包含格式正确的有效字符。
+ **DNS 记录 (HasValidDnsRecords'')**-检查域是否存在、是否有有效的 DNS 记录以及是否配置为接收电子邮件。
+ **邮箱存在 (MailboxExists'')**-检查邮箱是否存在并且可以在不实际发送电子邮件的情况下接收消息。
+ **角色地址 ('IsRoleAddress')**-标识参与率可能较低的基于角色的地址（例如 admin@、support@ 或 info@）。
+ **一次性域名 ('IsDisposable')**-检查可能对发件人声誉产生负面影响的一次性或临时电子邮件地址。
+ **随机字符串模式 ('IsRandomInput')**-检查随机生成的模式。

## 在 Amazon SES 控制台上使用 API 验证
<a name="email-validation-api-console"></a>

以下过程向您展示如何使用 Amazon SES 控制台验证电子邮件地址。

**使用 Amazon SES 控制台验证电子邮件地址**

1. 登录 AWS 管理控制台 并打开 Amazon SES 控制台，网址为[https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)。

1. 在左侧导航窗格中，选择**电子邮件验证下的电子邮件地址****验证**。

1. 在 “**验证电子邮件地址**” 部分，在 “电子邮件地址” 字段中输入要验证的**电子邮件地址**。

1. 选择**验证**。

   验证结果显示在 “**验证结果**” 面板中，显示：
   + **IsValid**— 带有置信度判断（高、中或低）的总体有效性。
   + **评估** — 个人评估结果以及上面列出的语法、DNS 记录、邮箱存在和风险因素的置信度判断。

## 将 API 验证与 AWS CLI
<a name="email-validation-api-cli"></a>

以下示例向您展示了如何使用验证电子邮件地址 AWS CLI。

**要使用验证电子邮件地址 AWS CLI**  
您可以使用 Amazon SES API v2 中的[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html)操作来验证电子邮件地址。您可以从调用此操作 AWS CLI，如以下示例所示。
+ 验证单个电子邮件地址：

  ```
  aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com
  ```
+ 响应类似于以下内容：

  ```
  {
      "MailboxValidation": {
          "IsValid": {
              "ConfidenceVerdict": "HIGH"
          },
          "Evaluations": {
              "HasValidSyntax": {
                  "ConfidenceVerdict": "HIGH"
              },
              "HasValidDnsRecords": {
                  "ConfidenceVerdict": "MEDIUM"
              },
              "MailboxExists": {
                  "ConfidenceVerdict": "MEDIUM"
              },
              "IsRoleAddress": {
                  "ConfidenceVerdict": "LOW"
              },
              "IsDisposable": {
                  "ConfidenceVerdict": "LOW"
              },
              "IsRandomInput": {
                  "ConfidenceVerdict": "LOW"
              }
          }
      }
  }
  ```
+ 有关响应值和数据类型的更多信息，请参阅 Amazon SES API v2 参考中的[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html)数据类型。
+ 确保您的 IAM 身份具有电子邮件验证 API 调用和发布 CloudWatch 指标所需的权限：

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

  API 验证调用需要该`GetEmailAddressInsights`权限，并`CreateServiceLinkedRole`允许发布验证活动的 CloudWatch指标。

**解释验证结果**  
验证响应包括可信度判决，可帮助您就电子邮件地址做出决定：
+ `IsValid`— 总体有效性评估，信心判定为高、中或低。有效性置信度高表示电子邮件地址的传送可能性高，中等表示送达可能性适中，低表示投递可能性低。
+ `Evaluations`— 个人评估结果，每项结果均附有信心判断：
  + `HIGH`— 对具体支票的强烈指示（例如，HI IsRandomInput GH 表示电子邮件很可能是随机生成的）。
  + `MEDIUM`— 对特定支票的适度指示（例如，MEDIUM 表示电子邮件地址很可能是随机生成的）。 IsRandomInput 
  + `LOW`— 具体支票的指示微弱或没有（例如，LOW IsRandomInput 表示电子邮件地址不太可能随机生成）。