メインコンテンツへスキップ
メールアドレス認証APIは2ステップのフローを提供します。まずメールアドレスにワンタイムコードを送信し、次にユーザーが入力したコードを検証します。また、情報漏洩の影響、使い捨てメールプロバイダーの検出、配信可能性のチェックを含むリスク評価も行います。

​
エンドポイント

メールコードの送信

POST /v3/email/send/：メールアドレスにワンタイム認証コードを送信します。

メールコードの確認

POST /v3/email/check/：コードを検証し、メールのリスクデータを取得します。

メールリスクのスコアリング

POST /v3/email/risk/：コードを送信せずに、配信可能性、情報漏洩、使い捨てメールのリスクをスコアリングします。

​
仕組み

  1. 対象のメールアドレスを指定してSend Email Codeを呼び出します
  2. ユーザーは6桁のコード（有効期間5分）を受け取ります
  3. メールアドレスとコードを指定してCheck Email Codeを呼び出します
  4. 認証結果とリスクシグナル（情報漏洩による影響、使い捨てプロバイダー、配信可能性）を受け取ります
デフォルトでは、スタンドアロンのOTPメールにはDiditのブランディングが使用されます。特定のスタンドアロンのメールアドレス認証セッションで、アプリケーションに設定したホワイトラベルの送信元とブランディングを使用するには、POST /v3/email/send/にoptions.use_white_label_customization: trueを渡します。デフォルトはfalseです。

​
リスクシグナル

チェックのレスポンスには以下が含まれます。 レスポンスの完全な構造については、メールアドレス認証レポートを参照してください。
最終更新日 2026年11月1日