メール認証の警告とリスクコード一覧

​

概要

​

自動却下の条件

• EMAIL_CODE_ATTEMPTS_EXCEEDED:ユーザーがOTPの試行回数を使い切りました。デフォルトでは、誤ったコードの入力2回(email_max_check_attempts)、またはOTPの送信2回(初回送信と再送信1回、email_max_retries)が上限です。
• EMAIL_IN_BLOCKLIST:メールアドレスがLists APIで管理されているブロックリストに含まれているか、過去に承認され、その後ブロックリストに登録されたメールアドレス認証と一致しました。
• UNDELIVERABLE_EMAIL_DETECTED:メールアドレスがメールを受信できません。原因は、無効な構文、存在しないドメイン、DNS(MX)レコードの欠如、またはOTPメールを配信できなかったことです。ステップは直ちにDeclinedとして確定し、コードの確認は一切行われません。例外として、ユーザーがメールアドレスを自分で入力した場合(セッション作成時に事前入力されていなかった場合)は、メールを配信できない場合はインラインのエラーが返され、却下される代わりに別のメールアドレスで再試行できます。

​

設定可能なリスク

​

認証試行回数の制限

• コード入力の試行回数:email_max_check_attempts、デフォルトは2回です。2回目の誤ったコード(または期限切れのコード)でステップが確定します。
• 送信の試行回数:email_max_retries、デフォルトは合計2回の送信(初回送信と再送信1回)です。それ以上の再送信リクエストでステップが確定します。

​

発生する警告

​

セッション間の一致

​

例

{
  "warnings": [
    {
      "feature": "EMAIL",
      "risk": "EMAIL_IN_BLOCKLIST",
      "additional_data": {
        "blocklisted_session_id": null,
        "blocklisted_session_number": null,
        "api_service": null
      },
      "log_type": "error",
      "short_description": "Email in blocklist",
      "long_description": "The system detected that the email is in the blocklist, which is not allowed.",
      "node_id": "feature_email_1"
    },
    {
      "feature": "EMAIL",
      "risk": "DISPOSABLE_EMAIL_DETECTED",
      "additional_data": null,
      "log_type": "information",
      "short_description": "Disposable email detected",
      "long_description": "The system detected that the email is disposable, which is not allowed.",
      "node_id": "feature_email_1"
    }
  ]
}

​

警告の種類

​

関連ページ

• メールアドレス認証の概要:機能の動作と料金。
• メールアドレス認証レポート:lifecycle[]とmatches[]を含むレスポンスの完全な構造。
• データモデル:メールアドレス認証:フィールドごとの正式なスキーマ。
• Management API:Lists:EMAIL_IN_BLOCKLISTで使用されるメールアドレスのブロックリストを管理します。