本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 電子郵件驗證 API
<a name="email-validation-api"></a>

API 驗證可讓您透過 API 呼叫驗證個別電子郵件地址，提供有關地址有效性、可交付性和風險因素的立即意見回饋。此功能旨在驗證集合的地址，例如在使用者註冊期間、訂閱表單或任何其他您需要及時驗證結果的情況。

API 驗證會對每個電子郵件地址執行多個檢查，包括語法驗證、網域驗證、信箱存在檢查等。驗證結果包括整體有效性和個別評估的可信度判定 (HIGH、MEDIUM 或 LOW)。

**執行的驗證檢查**  
API 驗證會對每個電子郵件地址執行下列評估：
+ **語法驗證 ('HasValidSyntax')** – 檢查電子郵件地址是否符合適當的 RFC 標準，並包含正確格式的有效字元。
+ **DNS 記錄 ('HasValidDnsRecords')** – 檢查網域是否存在、是否具有有效的 DNS 記錄，以及是否設定為接收電子郵件。
+ **Mailbox Existence ('MailboxExists')** – 檢查信箱是否存在，並且可以在不實際傳送電子郵件的情況下接收訊息。
+ **角色地址 ('IsRoleAddress')** – 識別可能具有較低參與率的角色型地址 （例如 admin@、support@ 或 info@)。
+ **一次性網域 ('IsDisposable')** – 檢查可能對寄件者評價造成負面影響的一次性或暫時電子郵件地址。
+ **隨機字串模式 ('IsRandomInput')** – 檢查隨機產生的模式。

## 搭配 Amazon SES 主控台使用 API 驗證
<a name="email-validation-api-console"></a>

下列程序說明如何使用 Amazon SES 主控台驗證電子郵件地址。

**使用 Amazon SES 主控台驗證電子郵件地址**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)：// 開啟 Amazon SES 主控台。

1. 在左側導覽窗格中，選擇**電子郵件驗證下的電子郵件地址****驗證**。

1. 在**驗證電子郵件地址**區段中，在電子郵件地址欄位中輸入您要驗證**的電子郵件地址**。

1. 選擇**驗證**。

   驗證結果會出現在**驗證結果**面板中，顯示：
   + **IsValid** – 具有可信度判定的整體有效性 (HIGH、MEDIUM 或 LOW)。
   + **評估** – 具有語法、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` – 整體有效性評估，可信度判定為 HIGH、MEDIUM 或 LOW。高有效性可信度表示電子郵件地址有高交付可能性，中表示有中等交付可能性，低表示有低交付可能性。
+ `Evaluations` – 個別評估結果，每個結果都有可信度判定：
  + `HIGH` – 明確指示特定檢查 （例如，IsRandomInput 為 HIGH 表示電子郵件很可能隨機產生）。
  + `MEDIUM` – 特定檢查的中度指示 （例如，IsRandomInput 的 MEDIUM 表示電子郵件地址有隨機產生的可能性）。
  + `LOW` – 特定檢查的不足或沒有指示 （例如，IsRandomInput 的 LOW 表示電子郵件地址不太可能隨機產生）。