6 人脸比对接口
使用说明: 人脸比对接口可使用于章节服务介绍中的人脸比对服务中,具体使用步骤请参考银行卡校验服务的时序图。
注意事项: 本接口通过AES加密进行通信。
6.1 功能描述
此接口用于对比两张人脸的相似度,并给出相似度评分,从而判断是否为同一个人。
6.2 接口路径
https://rra.tongfudun.com/func/face/compare
6.3 请求方式
POST(application/json)
6.4 提交参数(分为明文数据和明文加密后的数据)
构造的明文数据为:
参数 | 描述 | 备注 |
---|---|---|
texturedImage | 第一张照片(可设为网纹照) | 必填(base64编码) |
realImage | 第二张照片(可设为实景照) | 必填(base64编码) |
构造的密文数据为:
参数 | 描述 | 备注 |
---|---|---|
data | 密文数据 |
6.5 返回参数(分为密文数据和密文解密后的数据)
返回的加密数据为:
status | message | data |
---|---|---|
-100 | 加密数据,请解密后使用 | 密文 |
10031 | 签名校验失败 | |
10042 | 接口密钥通信失败,请联系管理员 | |
10044 | 加密异常,请联系管理员 |
-100状态下对应的密文解密后的数据
status | message | data |
---|---|---|
0 | 人脸对比通过 | {"similarity":"xxx(相似度的数值)","similarityThreshold":"xxx(相似度阈值)"} |
1 | 人脸对比不通过 | {"similarity":"xxx(相似度的数值)","similarityThreshold":"xxx(相似度阈值)"} |
-1 | 参数异常 | |
10011 | 服务异常,请联系通付盾管理员 | |
10032 | 该服务尚未开通 | |
10033 | 服务欠费,请充值 | |
10009 | (E*)人脸对比失败 |
6.6 示例
请求参数示例
加密前的数据: { "texturedImage":"图片的base64编码", "realImage":"图片的base64编码" } 加密后的数据: { "data":"密文" }返回结果示例
{ "status":"-100", "message":"加密数据,请解密后使用", "data":{}, "aesData":"密文" } 返回密文解密后的数据: { "status":"0", "message":"人脸比对通过", "data":{"similarity":"xxx(相似度的数值)","similarityThreshold":"xxx(相似度阈值)"} }