人脸特征校验

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