运营商三要素
HTTP接口请求参数
请求地址
- 国内:
http://api.open.tuputech.com/v3/recognition/mobile/verify/<secretId>
secretId 需替换为您的 secretId,请联系我们为您开通 secretId。
请求方法
POST
Header
参数名称 | 值 | 是否必需 | 说明 |
---|---|---|---|
Content-Type | application/json | 是 | 请求的数据类型 |
Body
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
phone | String | 是 | 手机号 |
name | String | 是 | 姓名 |
idNo | String | 是 | 身份证号码 |
timestamp | Number | 是 | 当前的服务器的Unix时间戳。 |
nonce | Number | 是 | 随机数。 |
signature | String | 是 | 我们采用的数字证书签名算法是:"RSA-SHA256" ,签名输出类型是:"base64" ,具体步骤如下:1、所有参与签名的参数为:secretId,timestamp,nonce,用英文半角逗号“,”相连,得到sign_string; 2、利用您的私钥,使用算法 "RSA-SHA256" 签名,输出为 "base64" 格式,得到参数signature的值。点击管理公钥证书查看如何生成私钥,及如何上传您的公钥用于数字签名的认证 |
HTTP接口返回
字段 | 类型 | 是否必需 | 说明 |
---|---|---|---|
json | String | 是 | 审核结果序列化字符串 |
signature | String | 是 | 签名 |
json
字段 | 类型 | 是否必需 | 说明 |
---|---|---|---|
code | Int | 是 | 状态码 |
message | String | 是 | 状态信息 |
label | Int | 是 | 结果标签 |
nonce | Number | 是 | 随机数 |
timestamp | Number | 是 | 当前的服务器的Unix时间戳 |
label描述
值 | 说明 |
---|---|
-1 | 其他错误,详细查看message。 |
0 | 匹配 【认证通过】 |
1 | 认证不通过:数据不一致 |
2 | 认证不通过:未查得【手机号】 |
3 | 手机号格式错误 |
4 | 身份证号格式错误 |
5 | 名字格式错误 |
响应结果结构示例
{
"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
}