跳到主要内容

手机号三要素校验

1. 接口介绍

基于用户授权,将用户手机号、姓名、身份证号信息,与权威数据源核对,检验信息的真实性和有效性。

2. 请求

2.1 请求地址

  • 国内: http://api.open.tuputech.com/v3/recognition/mobile/verify/<secretId>
提示

<secretId> 需替换为您的应用 SID,请联系客户经理为您开通及配置。关于 SID 详见 常见问题(FAQ)

2.2 请求方法

POST

2.3 请求头

参数名称是否必需说明
Content-Typeapplication/json请求的数据类型

2.4 请求参数说明

参数名称类型是否必需说明
phoneString手机号
nameString姓名
idNoString身份证号码
timestampNumber当前服务器的 Unix 时间戳。
nonceNumber随机数。
signatureString

RSA-SHA256 算法签名。签名步骤:

  1. 将参与签名的参数(secretIdtimestampnonce)用英文半角逗号 , 拼接,得到 SignString
  2. 使用您的私钥以 RSA-SHA256 算法对 SignString 签名,然后进行 Base64 编码,得到 signature 字符串。
  • 点击 数字证书 下载私钥。私钥有 rsapkcs8 两种格式,通常 Golang,Python 使用 rsa 格式私钥,Java 使用 pkcs8 格式私钥
  • 点击 签名及验证示例 查看签名示例

3. 返回结果

3.1 响应参数说明

字段类型是否必需说明
jsonString审核结果序列化字符串
signatureString签名

json

字段类型是否必需说明
codeInt状态码
messageString状态信息
labelInt结果标签
nonceNumber随机数
timestampNumber当前服务器的 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
}