SAAS云部署
PAAS私有化部署
文档中心
活体检测（动态）
1. 接口说明（活体检测动态）
1.1 发起请求
1.1.1 接口协议
HTTP POST
1.1.2 接口协议
https://api.juncyun.com/api/safFace/dynamicFaceCheck
1.1.3 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
multipart/form-data |
|
|
2） |
Content-Type |
multipart/form-data;charset=utf-8 |
|
1.1.4 请求参数
1.1.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填，从云极平台获取） |
|
|
2） |
accessSecret |
API调用密钥（必填，从云极平台获取） |
|
|
3） |
url |
视频文件地址，下载限时10秒，file和url二选一( 可选) |
|
|
4） |
file |
视频文件（MP4格式），适合本地文件上传，file和url二选一( 可选) |
|
|
5） |
motions |
用户动作序列:BLINK - 眨眼；MOUTH - 张嘴； NOD - 点头；YAW - 摇头 |
|
1.1.4.2. 请求参数示例
使用form-data格式传输。
1.1.5 响应参数
1.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
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 |
单个动作检测结果 |
|
1.1.5.2. 响应成功参数示例
{
"code": 200,
"msg": "核查通过",
"success": true,
"data": {
"face_image_url":"https://img2.jumdata.com/a.jpg",
"hack_score": 0.4493361287443779,
"requestId": "4529249871948222",
"fee": 1,
"motions": {
"score": 0.48755034492623084,
"motion": "BLINK",
"passed": true
},
"reqNo": "AI1705919990xx",
"passed": true,
"desc": "检测通过"
}
}
1.1.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
成功 |
|
500，501，503 |
系统错误 |
|
502 |
系统繁忙 |
|
60021 |
余额不足，请充值后重试！ |
|
10000 |
内部系统出错，请联系厂商 |
活体检测（动态）
1. 接口说明（活体检测动态）
1.1 发起请求
1.1.1 接口协议
HTTP POST
1.1.2 接口协议
https://api.juncyun.com/api/safFace/dynamicFaceCheck
1.1.3 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
multipart/form-data |
|
|
2） |
Content-Type |
multipart/form-data;charset=utf-8 |
|
1.1.4 请求参数
1.1.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填，从云极平台获取） |
|
|
2） |
accessSecret |
API调用密钥（必填，从云极平台获取） |
|
|
3） |
url |
视频文件地址，下载限时10秒，file和url二选一( 可选) |
|
|
4） |
file |
视频文件（MP4格式），适合本地文件上传，file和url二选一( 可选) |
|
|
5） |
motions |
用户动作序列:BLINK - 眨眼；MOUTH - 张嘴； NOD - 点头；YAW - 摇头 |
|
1.1.4.2. 请求参数示例
使用form-data格式传输。
1.1.5 响应参数
1.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
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 |
单个动作检测结果 |
|
1.1.5.2. 响应成功参数示例
{
"code": 200,
"msg": "核查通过",
"success": true,
"data": {
"face_image_url":"https://img2.jumdata.com/a.jpg",
"hack_score": 0.4493361287443779,
"requestId": "4529249871948222",
"fee": 1,
"motions": {
"score": 0.48755034492623084,
"motion": "BLINK",
"passed": true
},
"reqNo": "AI1705919990xx",
"passed": true,
"desc": "检测通过"
}
}
1.1.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
成功 |
|
500，501，503 |
系统错误 |
|
502 |
系统繁忙 |
|
60021 |
余额不足，请充值后重试！ |
|
10000 |
内部系统出错，请联系厂商 |
一对一服务，更有优惠惊喜
公众号
Copyright © 浙江卓见云科技有限公司 All Rights Reserved 浙ICP备16013515号-16