Didit 手机验证 API

概述

通过一次性验证码进行两步手机验证：

1. 1. 发送 验证码到手机号码
2. 检查 用户提供的验证码

关键限制：

• - 验证码在 5分钟 后过期
• 每个验证码最多 3次验证尝试（之后必须重新发送）
• 24小时内最多 2次重新发送请求
• 速率限制：每个手机号码 每小时最多发送4次
• 手机号码必须为 E.164格式（例如 +14155552671）
• 必须先调用发送接口，再调用检查接口

投递渠道： 短信（默认备用）、WhatsApp、Telegram、语音通话。如果首选渠道不可用，则回退到短信。

功能： 检测一次性/临时号码、VoIP号码、运营商信息以及重复号码。支持用于风险评分的欺诈信号。

API 参考： 发送验证码 | 检查验证码
功能指南： https://docs.didit.me/core-technology/phone-verification/overview

身份验证

所有请求都需要通过 x-api-key 请求头提供 API 密钥。

获取方式： Didit 业务控制台 → API 与 Webhooks → 复制 API 密钥，或通过编程方式注册（见下文）。

x-api-key: yourapikey_here

快速开始（还没有账户？）

如果您还没有 Didit API 密钥，可以通过 2 次 API 调用创建一个：

1. 1. 注册： POST https://apx.didit.me/auth/v2/programmatic/register/，请求体为 {email: you@gmail.com, password: MyStr0ng!Pass}
2. 检查邮箱 获取 6 位 OTP 验证码
3. 验证： POST https://apx.didit.me/auth/v2/programmatic/verify-email/，请求体为 {email: you@gmail.com, code: A3K9F2} → 响应中包含 api_key

添加积分： 使用 GET /v3/billing/balance/ 检查余额，使用 POST /v3/billing/top-up/ 并传入 {amountindollars: 50} 获取 Stripe 结账链接。

有关完整的平台管理（工作流、会话、用户、计费），请参阅 didit-verification-management 技能。

步骤 1：发送手机验证码

请求

POST https://verification.didit.me/v3/phone/send/

请求头

请求体（JSON）

示例

python
import requests

response = requests.post(
https://verification.didit.me/v3/phone/send/,
headers={x-api-key: YOURAPIKEY, Content-Type: application/json},
json={
phone_number: +14155552671,
options: {preferredchannel: sms, codesize: 6},
vendor_data: session-abc-123,
},
)

typescript
const response = await fetch(https://verification.didit.me/v3/phone/send/, {
method: POST,
headers: { x-api-key: YOURAPIKEY, Content-Type: application/json },
body: JSON.stringify({
phone_number: +14155552671,
options: { preferredchannel: sms, codesize: 6 },
}),
});

状态值及处理

错误响应

步骤 2：检查手机验证码

必须在成功发送验证码后调用。 可选择自动拒绝高风险号码。

请求

POST https://verification.didit.me/v3/phone/check/

请求体（JSON）

示例

python
response = requests.post(
https://verification.didit.me/v3/phone/check/,
headers={x-api-key: YOURAPIKEY, Content-Type: application/json},
json={
phone_number: +14155552671,
code: 123456,
disposablenumberaction: DECLINE,
voipnumberaction: DECLINE,
},
)

响应（200 OK）

json
{
request_id: e39cb057-...,
status: Approved,
message: 验证码正确。,
phone: {
status: Approved,