Skip to content

活体人脸核身-H5/小程序-获取认证结果


接口描述

根据传入的单据号,查询认证结果

请求说明

HTTP 方法:

POST

请求 URL:

/kaleidoscope-live/live/h5CheckFace/getResult

Header如下:

参数名称
Content-Typeapplication/json;charset=UTF-8

Body中放置请求参数,参数详情如下:

请求参数:

参数名称必填数据类型长度参数描述
certifyIdString1-32单据号
getFaceBoolean1-32是否返回人脸,默认false
getVideoBoolean1-32是否返回人脸,默认false
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "certifyId":"035143d350c646f68f4d25e44ff426c3",
    "getFace":true,
	"busFlowId":""
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeString1-8返回结果,00000000表示成功
messageString1-255返回码描述
dataObject-返回的数据
-resultBoolean1认证结果
-isAliveBoolean1活体标签(true:活体;false:非活体)
-hackCodeString1-32防攻击判断结果,详见防攻击码表
-msgString1-255检测信息
-isSameBoolean1比对结果(true:相似;false:不相似)
-imageString1-200k最佳人脸图像的人脸框(base64编码)
-videoBaseString1-500k检测视频(base64编码)

返回示例:

{
    "message": "success",
    "code": "00000000",
    "success": true,
    "data": {
        "result": true,
        "isAlive": true,
        "isSame": true,
        "hackCode": "1",
        "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
    }
}

防攻击码表:

(注:相同攻击类型不同错误码是为了区分算法模型以便后续算法分析)

攻击码描述
0无法判断
1活体
2疑似扣眼攻击
3疑似扣嘴攻击
4疑似半张脸攻击
5疑似视频回放攻击
6疑似黑白图片
7疑似纸面攻击
8疑似边框(包括纸面、手机等边框)
9疑似摩尔纹攻击
10疑似脸优攻击
11疑似纸面攻击(光流)
12疑似面具攻击
13疑似证卡攻击
14疑似3D面具攻击
16动作活体未检测到动作
20疑似不满足人行人脸识别图片质量要求
21疑似戴口罩/遮挡或者墨镜
22疑似未检测到人脸
23人脸检测或质量分或活体分模块运行异常
30动作活体判定为换人,提示请不要剧烈晃动屏幕
31动作活体判定为环境光太暗,提示增加环境光
32动作活体判定为环境光太亮,提示降低环境光
33动作活体判定没有正对屏幕,提示需要正对屏幕
34动作活体判定清晰度不够,提示确保光线自然,无晃动屏幕
35动作活体未检测到动作
50疑似合成图像攻击
51疑似合成图像攻击
52判疑似黑产软件攻击
53疑似T型面具攻击
54疑似黑白照片
55疑似模糊图片
56疑似深伪图像攻击
57疑似深伪图像攻击
58疑似高清屏幕攻击
59疑似3D面具攻击
60光线校验失败
61环境光太亮导致光线校验失败
62疑似设备存在风险
63疑似注入攻击
64疑似注入攻击
65疑似注入攻击
66疑似时间戳间隔小于预设值
67疑似篡改攻击
68疑似合成攻击
69前端没有通过的报文