人脸特征校验
使用人脸特征校验, 必须在应用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 |