翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# E メール検証 API
<a name="email-validation-api"></a>

API 検証を使用すると、API コールを通じて個々の E メールアドレスを検証し、アドレスの有効性、配信性能、リスク要因についてすぐにフィードバックを提供できます。この機能は、ユーザー登録、サブスクリプションフォーム、またはタイムリーな検証結果が必要なその他のシナリオなど、収集時にアドレスを検証するように設計されています。

API 検証は、構文検証、ドメイン検証、メールボックスの存在チェックなど、各 E メールアドレスに対して複数のチェックを実行します。検証結果には、全体的な有効性と個々の評価の信頼度判定 (HIGH、MEDIUM、または LOW) が含まれます。

**検証チェックの実行**  
API 検証は、各 E メールアドレスに対して次の評価を実行します。
+ **構文検証 ('HasValidSyntax')** – E メールアドレスが適切な RFC 標準に従っており、正しい形式の有効な文字が含まれていることを確認します。
+ **DNS レコード ('HasValidDnsRecords')** – ドメインが存在し、有効な DNS レコードがあり、E メールを受信するように設定されていることを確認します。
+ **メールボックスの存在 ('MailboxExists')** – メールボックスが存在し、実際に E メールを送信せずにメッセージを受信できることを確認します。
+ **ロールアドレス ('IsRoleAddress')** – エンゲージメント率が低い可能性のあるロールベースのアドレス (admin@、support@、info@ など) を識別します。
+ **ディスポーザブルドメイン (IsDisposable」)** — 送信者の評価に悪影響を及ぼす可能性のある、ディスポーザブルまたは一時的な E メールアドレスをチェックします。
+ **ランダム文字列パターン ('IsRandomInput')** – ランダムに生成されたパターンをチェックします。

## Amazon SES コンソールでの API 検証の使用
<a name="email-validation-api-console"></a>

次の手順では、Amazon SES コンソールを使用して E メールアドレスを検証する方法を示します。

**Amazon SES コンソールを使用して E メールアドレスを検証するには**

1.  AWS マネジメントコンソール にサインインし、Amazon SES コンソール ([https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)) を開きます。

1. 左側のナビゲーションペインで、E **メール検証**で **E メールアドレス検証**を選択します。

1. E **メールアドレスの検証**セクションで、検証する E メールアドレスを **E メールアドレス**フィールドに入力します。

1. **[検証]** を選択します。

   検証結果は**検証結果**パネルに表示され、以下が表示されます。
   + **IsValid** – 信頼度判定 (HIGH、MEDIUM、または LOW) による全体的な有効性。
   + **評価** – 上記の構文、DNS レコード、メールボックスの存在、リスク要因の信頼度判定を含む個々の評価結果。

## での API 検証の使用 AWS CLI
<a name="email-validation-api-cli"></a>

次の例は、 を使用して E メールアドレスを検証する方法を示しています AWS CLI。

**を使用して E メールアドレスを検証するには 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)オペレーションを使用して、E メールアドレスを検証できます。次の例に示すように AWS CLI、 からこのオペレーションを呼び出すことができます。
+ 1 つの E メールアドレスを検証します。

  ```
  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 ID に、E メール検証 API コールと CloudWatch メトリクスの発行に必要なアクセス許可があることを確認します。

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

  アクセス`GetEmailAddressInsights`許可は API 検証コールに必要であり、検証アクティビティの CloudWatch メトリクスの発行`CreateServiceLinkedRole`を有効にします。

**検証結果の解釈**  
検証レスポンスには、E メールアドレスに関する意思決定に役立つ信頼度判定が含まれます。
+ `IsValid` – 高、中、または低の信頼度判定による全体的な有効性評価。高い有効性の信頼度は、E メールアドレスの配信可能性が高く、MEDIUM は中程度の配信可能性を示し、LOW は配信可能性が低いことを示します。
+ `Evaluations` – 個々の評価結果。各評価結果には信頼度判定があります。
  + `HIGH` – 特定のチェックの強力な表示 (IsRandomInput の HIGH などは、E メールがランダムに生成される可能性が非常に高いことを意味します）。
  + `MEDIUM` – 特定のチェックを中程度に示します (例: IsRandomInput の MEDIUM は、E メールアドレスがランダムに生成される可能性があることを意味します）。
  + `LOW` – 特定のチェックが弱い、または表示されない (例: IsRandomInput の LOW は、E メールアドレスがランダムに生成される可能性が低いことを意味します）。