電子郵件驗證 API - Amazon Simple Email Service
API 驗證 （主控台）API 驗證 (AWS CLI)

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

電子郵件驗證 API

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

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

執行的驗證檢查

API 驗證會對每個電子郵件地址執行下列評估：

  • 語法驗證 ('HasValidSyntax') – 檢查電子郵件地址是否符合適當的 RFC 標準，並包含正確格式的有效字元。

  • DNS 記錄 ('HasValidDnsRecords') – 檢查網域是否存在、是否具有有效的 DNS 記錄，以及是否設定為接收電子郵件。

  • Mailbox Existence ('MailboxExists') – 檢查信箱是否存在，並且可以在不實際傳送電子郵件的情況下接收訊息。

  • 角色地址 ('IsRoleAddress') – 識別可能具有較低參與率的角色型地址 （例如 admin@、support@ 或 info@)。

  • 一次性網域 ('IsDisposable') – 檢查可能對寄件者評價造成負面影響的一次性或暫時電子郵件地址。

  • 隨機字串模式 ('IsRandomInput') – 檢查隨機產生的模式。

搭配 Amazon SES 主控台使用 API 驗證

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

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

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

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

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

  4. 選擇驗證。

    驗證結果會出現在驗證結果面板中，顯示：

    • IsValid – 具有可信度判定的整體有效性 (HIGH、MEDIUM 或 LOW)。

    • 評估 – 具有語法、DNS 記錄、信箱存在和上述風險因素可信度判定的個別評估結果。

搭配 使用 API 驗證 AWS CLI

下列範例示範如何使用 驗證電子郵件地址 AWS CLI。

使用 驗證電子郵件地址 AWS CLI

您可以使用 Amazon SES API v2 中的 GetEmailAddressInsights操作來驗證電子郵件地址。您可以從 呼叫此操作 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 參考中的MailboxValidation資料類型。

  • 確保您的 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 表示電子郵件地址不太可能隨機產生）。