手机号三要素校验
1. 接口介绍
基于用户授权,将用户手机号、姓名、身份证号信息,与权威数据源核对,检验信息的真实性和有效性。
2. 请求
2.1 请求地址
- 国内:
https://api.open.tuputech.com/v3/recognition/mobile/verify/<secretId>
提示
<secretId>
需替换为您的应用 SID
,请联系客户经理为您开通及配置。关于 SID
详见 常见问题(FAQ)。
2.2 请求方法
POST
2.3 请求头
参数名称 | 值 | 是否必需 | 说明 |
---|---|---|---|
Content-Type | application/json | 是 | 请求的数据类型 |
危险
由于模型基于请求流量动态伸缩,在空闲一定时间后会关闭(部分专用模型空闲一定时间后会关闭全部实例)。
由于模型冷启动耗时较长,部分请求可能无法处理,最终返回非 200
HTTP 状态码或业务状态码 101
。该现象可能在以下情况下出现:
- 初次请求
- 长时间未调用后再次请求
- 请求流量突增
- 请求存在规律性的流量波动(例如每隔超过 5 分钟请求一批数据,或仅在工作日期间有大量请求)
针对以上情况,我们分别建议您:
- 间隔 2~3 分钟后重试
- 间隔 2~3 分钟后重试,并且后续保持至少每分钟 1 次调用
- 提前进行预热,或及时联系我们扩容
- 调整业务请求时间间隔到 5 分钟内,或联系我们调整实例保持策略。若您的业务仅在工作日期间有大量请求,节假日期间较少,请务必联系我们
2.4 请求参数说明
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
phone | String | 是 | 手机号 |
name | String | 是 | 姓名 |
idNo | String | 是 | 身份证号码 |
timestamp | Number | 是 | 当前服务器的 Unix 时间戳。 |
nonce | Number | 是 | 随机数。 |
signature | String | 是 |
|
3. 返回结果
3.1 响应参数说明
字段 | 类型 | 是否必需 | 说明 |
---|---|---|---|
json | String | 是 | 审核结果序列化字符串 |
signature | String | 是 | 签名 |
json
字段 | 类型 | 是否必需 | 说明 |
---|---|---|---|
code | Int | 是 | 状态码 |
message | String | 是 | 状态信息 |
label | Int | 是 | 结果标签 |
nonce | Number | 是 | 随机数 |
timestamp | Number | 是 | 当前服务器的 Unix 时间戳 |
3.2 返回标签说明
Label 值 | 说明 |
---|---|
-1 | 其他错误,详细查看 message 的内容 |
0 | 认证通过 |
1 | 认证不通过:数据不一致 |
2 | 认证不通过:未查到手机号 |
3 | 手机号格式错误 |
4 | 身份证号格式错误 |
5 | 名字格式错误 |
3.3 响应示例
{
"json": "{\"label\":4,\"code\":0,\"message\":\"success\",\"nonce\":\"0.1148440632584542\",\"timestamp\":1631850679903}",
"signature": "h4WInQPxNjEWTa/B2mS4lpVcJi9wgXWCkLarlNT4NMlyt50eGggBdlAThiS6AJGWW0CweMjKNys04on8QqpSjxh298GE3GieU2Tw3IyyLQiL2j40tA2i/Ib00zYQ99QgqGlnbVqJjYGYte0sJdLkIfwIFfsuPbseMQxm3h2VHig="
}
json
字段示例
{
"label": 4,
"code": 0,
"message": "success",
"nonce": "0.1148440632584542",
"timestamp": 1631850679903
}