接口协议:
HTTP POST
接口方法(静态活体检测):
https://api.juncyun.com/api/safFace/staticFaceCheck
报头定义:
请求参数列表:
编码 | 列表 | 内容 | 备注 |
1 | accessKey | API调用账号(必填,String类型,从云极平台获取) | |
2 | accessSecret | API调用密钥(必填,String类型,从云极平台获取) | |
3 | image | 人脸照(必填) | 活体检测的自拍照片说明:imageType 为 URL 时,传入照片的网络 URL 地址 imageType 为 BASE64 时,传入照片的 base64 字符编码,base64 字符串不包含 data:image 前缀,base64字符串去掉头部描述(如 data:image/png;base64)支持图片类型:jpg/png/bmp,且图片大小不能大于 2M |
4 | imageType | 类型(必填) | 图片类型,枚举值:URL-图片路径 ,BASE64 –图片 BASE64 编码 |
请求参数示例:
响应参数列表:
编码 | 列表 | 内容 | 备注 |
1 | code | 状态码200则为成功 | |
2 | msg | 状态说明 | |
3 | success | 处理是否成功:取值范围true,false | |
4 | data | 业务数据如果失败则为空 | |
5 | +score | 活体检测的分值,大于 87 分可判断为活体 | |
6 | +code | 活体检测返回码,0 表示成功,其他为失败 | |
7 | +tradeNo | 交易号 | |
8 | +fee | 是否扣费 0不收费1收费 | |
9 | +remark | 检测说明 | |
10 | +reqNo | 请求序列号 | |
11 | +checkStatus | 检测结果,1 表示为活体,0 表示非活体 |
响应参数示例:
结果码说明:
结果码 | 描述 |
200 | 成功 |
500,501,503 | 系统错误 |
502 | 系统繁忙 |
60021 | 余额不足,请充值后重试! |
10000 | 内部系统出错,请联系厂商 |
接口协议:
HTTP POST
接口方法(动态活体检测):
https://api.juncyun.com/api/safFace/dynamicFaceCheck
报头定义:
请求参数列表:
编码 | 列表 | 内容 | 备注 |
1 | accessKey | API调用账号(必填,String类型,从云极平台获取) | |
2 | accessSecret | API调用密钥(必填,String类型,从云极平台获取) | |
3 | url | 视频文件地址,下载限时10秒,file和url二选一( 可选) | |
4 | file | 视频文件,适合本地文件上传,file和url二选一( 可选) | |
5 | motions | 用户动作序列:BLINK - 眨眼;MOUTH - 张嘴; NOD - 点头;YAW - 摇头 |
请求参数示例:
使用form-data格式传输。
响应参数列表:
编码 | 列表 | 内容 | 备注 |
1 | code | 状态码200则为成功 | |
2 | msg | 状态说明 | |
3 | success | 处理是否成功:取值范围true,false | |
4 | data | 业务数据如果失败则为空 | |
5 | +reqNo | 请求序列号 | |
6 | +passed | 总体检测结果,true - 通过,false - 未通过 | |
7 | ++desc | passed为false 活体检查失败的原因 | |
8 | +requestId | 流水号 | |
9 | +fee | 是否扣费 0不收费1收费 | |
10 | ++face_image_url | 活体成功之后,抓取的人脸照片 | |
11 | ++hack_score | 防hack检测分数,hack_score阈值为0.98,由行业大数据训练得到,大于0.98是hack行为,小于等于0.98是正常活人 | |
12 | ++motions | 用户动作序列 | |
13 | +++motion | 用户动作序列 | |
14 | +++score | 单个动作分值 > 0.2表示通过,<= 0.2表示不通过 | |
15 | +++passed | 单个动作检测结果 |
响应参数示例:
结果码说明:
结果码 | 描述 |
200 | 成功 |
500,501,503 | 系统错误 |
502 | 系统繁忙 |
60021 | 余额不足,请充值后重试! |
10000 | 内部系统出错,请联系厂商 |
欢迎留言咨询,我们会第一时间与您联系!