1. 接口描述

系统根据用户上传的自拍照片，来通过面部图像验证用户身份的真实性。

使用人脸关键点定位和人脸追踪等技术，通过大数据风控能力和深度学习，检测图片中的人脸是否为真人活体，验证用户是否为真实活体操作。

2. 使用场景

安防行业：门禁（学校、小区、社区等），考勤（学校、企业等）

游戏行业：各种游戏账号注册、实名认证以及虚拟货币交易验证等方面

金融行业：用户开户、登录、实名认证、网上支付等环节的身份验证

广泛应用于数字门店、楼宇门禁、身份识别、互动娱乐、IPC摄像头、内容广告等领域。

3. 接口说明（静态活体检测）

3.1. 发起请求

3.1.1. 接口协议

HTTP  POST

3.1.2. 接口方法

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

3.1.3. 报头定义

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

 

3.1.4. 请求参数

3.1.4.1. 请求参数列表

编码	列表	内容	备注
1）	accessKey	API调用账号（必填，从云极平台获取）
2）	accessSecret	API调用密钥（必填，从云极平台获取）
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 编码

 

3.1.4.2. 请求参数示例

{

  "accessKey":"87d0373b**********",

  "accessSecret":"b20d7c5e1c********************",

  "imageType":"BASE64",

  "image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"

}

 

3.1.5. 响应参数

3.1.5.1. 响应参数列表

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

 

3.1.5.2. 响应成功参数示例

{

"code": 200,

"msg": "核查通过",

"success": true,

"data": {

"score": "97",

"checkStatus": "1",

"code": "0",

"tradeNo": "1199065668992220000",

"fee": 1,

"reqNo": "AI1705921132xxxxxx4",

"remark": "检测成功"

}

}

 

3.1.5.3. 结果码说明

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