人脸实名认证
HTTP接口请求参数
Path
api.open.tuputech.com/v3/recognition/face/verify/{your_secret_id} 'your_secretId'需替换为您的secretId,请联系我们为您开通secretId。
请求方法
POST
Header
参数名称 | 值 | 是否必需 | 说明 |
---|---|---|---|
Content-Type | application/json | 是 | 请求的数据类型 |
Body
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
image | String | 是 | 图片链接或base64数据 |
imageType | String | 是 | url 或者 base64 |
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 | 是 | 结果标签 |
rate | Float64 | 是 | 标签置信度[0.0 - 1.0] |
review | Boolean | 是 | 是否复审 |
featureId | String | 否 | 人脸特征ID,认证通过时返回,如“6da8741182ccbfb9084a7e7c4bffe144” |
label描述
值 | 说明 |
---|---|
-1 | 其他错误,详细查看message。 |
0 | 认证通过 |
1 | 认证不通过:人脸质量不符合要求 |
2 | 认证不通过:非活体 |
3 | 认证不通过:实名认证失败 |
4 | 身份证号格式错误 |
5 | 名字格式错误 |
6 | 身份证号和名字不匹配 |
响应结果结构示例
{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}
json示例
{
"rate":0.9927366971969604,
"label":0,
"review":false,
"code":0,
"featureId": "6da8741182ccbfb9084a7e7c4bffe144",
"message":"success",
"nonce": "0.5442530125172196",
"timestamp":1595318082309
}