主题
活体检测/核身/比对-获取认证结果
接口描述
根据传入的单据号，查询认证结果
进行接口调用前，需要获取必要的token信息，可查看登录鉴权。 该接口为加密接口，可查看签名与加密方式配置加密秘钥，并对接口内容进行加密。
请求说明
HTTP 方法:
POST请求 URL：
/kaleidoscope-live/live/antispoof/v2/getResultHeader如下：
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数，参数详情如下：
请求参数：
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| certifyId | 是 | String | 1-32 | 单据号 |
| getFace | 否 | Boolean | 1-32 | 是否返回人脸 ,默认false |
| getVideo | 否 | Boolean | 1-32 | 是否返回人检测视频 ,默认false |
| getScore | 否 | Boolean | 1-32 | 是否返回人脸评分 ,默认false |
请求示例：
{
"certifyId":"1004824012104138752",
"getFace":true,
"getVideo":false,
"getScore":false
}返回说明
返回参数：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | String | 1-8 | 返回结果，00000000表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -isAlive | int | 4 | 是否是真人 0是1否 |
| -isSame | int | 4 | 比对是否相似 /活体抓拍的照片与公安联网核查人像比对是否一致 0是1否 二合一接口返回该信息 |
| -liveCode | String | 1-32 | 活体检测结果，详见活体检测结果码表 |
| -msg | String | 1-255 | 失败描述信息 |
| -image | String | 1-200k | 最佳人脸图片base64 getFace为true时返回该字段 |
| -videoBase | String | 1-500k | 检测视频（base64编码） getVideo为true时返回该字段 |
| -flowId | String | 1-64 | 交易流水ID（建议保存） |
| -score | double | 2,6 | 比对分(0-100)，二合一接口且getScore为true时返回该字段 |
返回示例：
{
"message": "success",
"code": "00000000"
"success": true,
"data": {
"image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDABALDA4MChAODQ4SERAT...",
"isAlive":0,
"isSame":0,
"liveCode": 1,
"msg":"",
"videoBase":"",
"flowId":"xxxxxxxxxxxxxxx",
"score":99.9
}
}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 80003508 | 否 | 是 | 防攻击核查检测未通过 返回该错误码时，liveCode返回值范围为 0-70 |
| 00000100 | 否 | 是 | 核查通过，疑似为同一人 |
| 00000101 | 否 | 是 | 核查通过，判断为不同人 |
| 00000102 | 否 | 是 | 核查通过，照片质量不合格 |
| 00000103 | 否 | 是 | 核查通过，渠道无照片 |
| 00000200 | 否 | 是 | 核查失败，姓名和身份证不匹配 |
| 00000201 | 否 | 是 | 核查失败，未找到相关信息 |
| 00000202 | 否 | 是 | 核查失败姓名、证件号格式有误 |
| 00000301 | 否 | 否 | 系统错误，请重试 |
| 00000302 | 否 | 否 | 渠道调用异常 |
| 00000303 | 否 | 否 | 服务到期 |
| 00000304 | 否 | 否 | 余额不足 |
| 00000305 | 否 | 否 | 试用账号赠送次数已用完 |
| 00000306 | 否 | 否 | 渠道配置错误 |
| 80003500 | 否 | 否 | 防攻击检测异常 |
| 80003501 | 否 | 否 | 查询防攻击检测结果异常 |
| 80003502 | 否 | 否 | 防攻击比对检测异常 |
| 80003503 | 否 | 否 | 防攻击核查检测异常 |
| 80003506 | 否 | 否 | 接口类型不符 |
| 80003507 | 否 | 否 | SDK动作检测失败 返回该错误码时，liveCode返回值范围为 700以上 |
| 50029007 | 否 | 否 | 人脸比对-异常 `` |
活体检测结果码表：
（注：相同攻击类型不同错误码是为了区分算法模型以便后续算法分析）
| 活体检测结果码（liveCode） | 描述 |
|---|---|
| 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 | 前端没有通过的报文 |
| 700 | 没有检测到人脸 |
| 702 | 检测到换人 |
| 703 | 检测超时 |
| 704 | 检测到做了要求以外的其他动作 |
| 705 | 检测过程中锁屏或退出后台 |
| 706 | 活体验证失败 |
| 707 | 检测到劫持 |
| 708 | 其他攻击 |
| 709 | 设备存在安全隐患 越狱 |
| 710 | 没有相机权限 |
| 714 | SDK初始化失败_授权失败 |
| 715 | SDK初始化失败_模型文件加载失败 |
| 716 | SDK初始化失败_其他失败 |
| 717 | UI不被支持 |
| 718 | bundleID |
| 719 | 检测到攻击(视频注入攻击) |
| 738 | 报文生成失败 |
| 739 | 用户授权信息验证失败 |
| 745 | 重试次数用完 |
| 754 | 检测到网络环境不安全 |
| 755 | 没有加速度传感器权限 |
| 758 | 录屏或投屏 |
| 759 | USB连接 |
| 760 | 虚拟位置 |
| 761 | 未插入sim卡 |
| 762 | 模拟器 |
| 763 | 沙盒环境 |
| 764 | 存在xposed注入 |
| 765 | 存在frida注入 |
| 766 | 应用多开 |
| 767 | 设备处于开发者模式 |
| 768 | 设备被boot解锁 |
| 769 | 高危ROM |
| 770 | 非常规ROM |
| 771 | 自动化环境 |
| 772 | 云手机 |