人脸特征校验
使用人脸特征校验, 必须在应用ID同时开通人脸实名认证
和人脸校验
任务。 人脸实名认证通过以后,返回此人脸对应特征ID。人脸特征校验,上传实时图片判断人脸是否和对应实名认证返回特征ID的人脸匹配。
HTTP接口请求参数
Path
http://api.open.tuputech.com/v3/recognition/face/feature-compare/{your_secret_id} 'your_secretId'需替换为您的secretId,请联系我们为您开通secretId。
请求方法
POST
Header
参数名称 | 值 | 是否必需 | 说明 |
---|---|---|---|
Content-Type | application/json | 是 | 请求的数据类型 |
Body
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
image | String | 是 | 图片链接或base64数据 |
imageType | String | 是 | url 或者 base64 |
featureId | String | 是 | 特征id【实名认证通过后返回featureId】 |
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 | 是 | 是否复审 |
label描述
值 | 说明 |
---|---|
-1 | 其他错误,详细查看message。 |
0 | 匹配 |
1 | 不匹配 |
响应结果结构示例
{
"signature": "signature_from_tupu_service",
"json":"{\"label\":0,\"rate\":1,\"review\":false,\"code\":0,\"message\":\"success\",\"nonce\":\"0.9584921607052261\",\"timestamp\":1633916118783}"
}
json示例
{
"rate": 0.9584921607052261,
"label":0,
"review":false,
"code":0,
"message":"success",
"nonce": "0.9584921607052261",
"timestamp":1633916118783
}
常见code错误码说明
值 | 说明 |
---|---|
26 | 无效人脸特征校验应用ID。 应用必须同时开通任务【人脸实名认证, 人脸校验】才可以使用此接口,请联系我们开通。 |
27 | 无效人脸特征ID |