> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# メール認証API：OTPとリスクスコアリング

> DiditのメールAPIは、2ステップのOTPでメールアドレスを認証し、情報漏えい・使い捨てアドレス・到達性のリスクをスコアリングします。従量課金で認証1件あたり$0.02。

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

## エンドポイント

> [card] [メールコードの送信](https://docs.didit.me/ja/standalone-apis/email-send.md)
>
> `POST /v3/email/send/`：メールアドレスにワンタイム認証コードを送信します。

> [card] [メールコードの確認](https://docs.didit.me/ja/standalone-apis/email-check.md)
>
> `POST /v3/email/check/`：コードを検証し、メールのリスクデータを取得します。

> [card] [メールリスクのスコアリング](https://docs.didit.me/ja/standalone-apis/email-risk.md)
>
> `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`です。

## リスクシグナル

チェックのレスポンスには以下が含まれます。

| シグナル | 説明 |
| - | - |
| `is_breached` | 既知の情報漏洩でメールアドレスが見つかった |
| `is_disposable` | 一時的な使い捨てメールプロバイダー |
| `is_undeliverable` | アドレスがメールを受信できない |

レスポンスの完全な構造については、[メールアドレス認証レポート](https://docs.didit.me/ja/core-technology/email-verification/overview.md)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.