> ## 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 提供两步 OTP 邮箱验证，并结合泄露、一次性邮箱和送达率风险评分。按量计费，每次验证 $0.02。

Email Verification API 提供两步流程：向邮箱地址发送一次性验证码，然后验证用户输入的验证码。系统还会执行风险评估，包括数据泄露情况、一次性邮箱服务商检测和可送达性检查。

## 端点

> [card] [发送邮箱验证码](https://docs.didit.me/zh/standalone-apis/email-send.md)
>
> `POST /v3/email/send/` — 向邮箱地址发送一次性验证码。

> [card] [检查邮箱验证码](https://docs.didit.me/zh/standalone-apis/email-check.md)
>
> `POST /v3/email/check/` — 验证用户输入的验证码并获取邮箱风险数据。

> [card] [邮箱风险评分](https://docs.didit.me/zh/standalone-apis/email-risk.md)
>
> `POST /v3/email/risk/` — 在不发送验证码的情况下，对可送达性风险、数据泄露风险和一次性邮箱风险进行评分。

## 工作原理

1. 使用目标邮箱地址调用 **发送邮箱验证码**
2. 用户会收到一个 6 位验证码（有效期 5 分钟）
3. 使用邮箱和验证码调用 **检查邮箱验证码**
4. 接收验证结果以及风险信号（数据泄露暴露情况、一次性邮箱服务商、可送达性）

默认情况下，独立 OTP 邮件使用 Didit 品牌。若要对某个独立邮箱验证会话使用您应用中配置的白标发件人和品牌，请在调用 `POST /v3/email/send/` 时传入 `options.use_white_label_customization: true`。默认值为 `false`。

## 风险信号

检查响应包含以下内容：

| 信号 | 说明 |
| - | - |
| `is_breached` | 邮箱出现在已知的数据泄露事件中 |
| `is_disposable` | 临时或一次性邮箱服务商 |
| `is_undeliverable` | 该地址不接收邮件 |

完整的响应结构，请参阅 [邮箱验证报告](https://docs.didit.me/zh/core-technology/email-verification/overview.md)。


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