接口协议：

HTTP POST

接口方法（静态活体检测）：

https://api.juncyun.com/api/safFace/staticFaceCheck

报头定义：

编码 列表 内容 备注 1 Accept application/json 2 Content-Type application/json;charset=utf-8

请求参数列表:

编码	列表	内容	备注
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 编码

请求参数示例：

• {
• 　　　　"accessKey":"ee8b880f**********",
• 　　　　"accessSecret":"f19cc1d82d********************",
• 　　　　"imageType":"BASE64",
• 　　　　"image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"
• }

响应参数列表：

编码	列表	内容	备注
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 表示非活体

响应参数示例：

• {
• "code":200,
• "msg": "核查通过",
• "success":true,
• "data":{
• "score": "97",
• "checkStatus": "1",
• "code": "0",
• "tradeNo": "1199065668992220000",
• "fee": 1,
• "reqNo": "AI1705921132xxxxxx4",
• "remark": "检测成功"
• }
• }

结果码说明：

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商

接口协议：

HTTP POST

接口方法（动态活体检测）：

https://api.juncyun.com/api/safFace/dynamicFaceCheck

报头定义：

编码 列表 内容 备注 1 Accept multipart/form-data 2 Content-Type multipart/form-data;charset=utf-8

请求参数列表:

编码	列表	内容	备注
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	单个动作检测结果

响应参数示例：

• {
• "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": "检测通过"
• }
• }

结果码说明：

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商