人脸特征校验

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

results matching ""

    No results matching ""