端点
发送电话验证码
POST /v3/phone/send/:通过短信发送一次性验证码。检查电话验证码
POST /v3/phone/check/:核验验证码并获取电话风险数据。电话风险评分
POST /v3/phone/risk/:在不发送 OTP 的情况下,对运营商、线路类型、携号转网和欺诈风险进行评分。工作原理
- 调用 Send Phone Code,传入 E.164 格式的电话号码(例如
+14155552671) - 用户通过短信收到验证码(有效期为 5 分钟)
- 调用 Check Phone Code,传入电话号码和验证码
- 获取验证结果以及风险信号(运营商类型、虚拟号码检测)
投递渠道
Didit 支持多种渠道,具体取决于国家或地区的可用情况:风险信号
有关完整的响应结构,请参阅 电话验证报告。
服务提供商故障
如果上游电话服务提供商未能响应发送或检查请求,两个端点都会返回502 和 code: "phone_provider_unavailable",而不是通用错误。此错误可以安全重试,不计费,也不会占用每个号码每小时上限中的一次尝试次数。请根据 code 进行分支处理,而不要解析 detail 消息,因为消息文本不是稳定的接口约定。