人脸照片核验比对

更新时间:2025-01-23 18:05:41

接口描述

上传用户的人脸照片,与用户的姓名、证件号,核验照片是否为本人,接口将返回信息比对的结果。

接口地址

/v2/identity/verify/individual/faceCompare/withoutSource

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

方式一:请求签名鉴权(优先推荐)

参数名称

类型

必选

参数说明

X-Tsign-Open-App-Id

string

应用ID

Content-Type

string

application/json;charset=UTF-8

X-Tsign-Open-Ca-Timestamp

string

API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击

Accept

string

建议统一填写 */*

X-Tsign-Open-Ca-Signature

string

签名字符串

Content-MD5

string

当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。

X-Tsign-Open-Auth-Mode

string

选择请求方式进行鉴权,固定值,Signature

方式二:OAuth2.0鉴权(不推荐使用)

当安全接入选择OAuth2.0鉴权方式请点击查阅详情。

请求参数

参数名称

类型

必选

参数类型

参数说明

name

string

body

姓名

idNo

string

body

身份证号

faceImgBase64

string

body

人像照片Base64编码

注:不包含格式前缀

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

业务码,0表示成功

message

string

信息

data

object

业务信息

verifyId

string

信息比对业务Id,请注意保存该参数

confidence

int

库照比对综合分数,取值:[0,100]

  • 可判断为同一人的取值范围:[70,100]
  • 数字越大表示相似度越高

请求示例  


{
    "name":"xx",
    "idNo":"330204xxxxxxxx1221",
    "faceImgBase64":"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"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "7a143dab-770e-1111-af21-513938addc51",
        "confidence": 99
    }
}
我要纠错