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

端点

发送邮箱验证码

POST /v3/email/send/ — 向邮箱地址发送一次性验证码。

检查邮箱验证码

POST /v3/email/check/ — 验证用户输入的验证码并获取邮箱风险数据。

邮箱风险评分

POST /v3/email/risk/ — 在不发送验证码的情况下,对可送达性风险、数据泄露风险和一次性邮箱风险进行评分。

工作原理

  1. 使用目标邮箱地址调用 发送邮箱验证码
  2. 用户会收到一个 6 位验证码(有效期 5 分钟)
  3. 使用邮箱和验证码调用 检查邮箱验证码
  4. 接收验证结果以及风险信号(数据泄露暴露情况、一次性邮箱服务商、可送达性)
默认情况下,独立 OTP 邮件使用 Didit 品牌。若要对某个独立邮箱验证会话使用您应用中配置的白标发件人和品牌,请在调用 POST /v3/email/send/ 时传入 options.use_white_label_customization: true。默认值为 false。

风险信号

检查响应包含以下内容: 完整的响应结构,请参阅 邮箱验证报告。
最后修改于 2026年11月7日