手机号三要素校验
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
}