一.准备工作
本文是实人认证H5的接入文档，用于指导WEB应用开发人员接入，并详细描述接入流程和使用方法，默认读者已经具有一定的编程知识基础。
注意事项
- app内嵌H5时，如果用户拒绝授权相机权限需要用户卸载重装app才能重新唤起授权弹框
- 当选择身份证二要素输入后会自动进入活体检测环节，当活体检测成功时才会进行人像比对
创建应用
- 开发者使用账号登录创蓝智能云平台 (www.chuanglan.com )，填写信息创建应用。
- 审核通过后，开发者可以在应用详情中获取到应用的appId和appKey，后续集成对接中会使用。
体验demo
- 我们提供了一个 web 页面的【demo示例】，通过示例可以体验H5版本的基本用法。
集成SDK
- 在页面中引入实人认证Web SDK的JS文件与CSS文件，以V2.0.2版本为例：
<script src="https://static2.253.com/wanshu/sdk/shiren/living2.0.2.min.js"></script>
二.实人认证API
jmliving({ appKey: '***', authToken: '***' }, function (data) {
console.log('data', data);
});
【 参数说明 】
【 返回示例 】
- 当state传1时，返回示例
{
"state": 4,
"app_key": "WuH3i49j",
"auth_token": "EB0D0AD091A6429696F8BA6AC5E5C215",
"front_image": "/9j/4AAQSkZ",
"back_image": "/9j/4AAQSkZJ",
"image_type": "BASE64",
"idCard": "",
"userName": "",
"code": "200",
"file": {},
"score": 0.6228859361694794,
"message": "pass"
}
{
code: "200", //状态码
app_key: "***", //appKey
auth_token: "***",//authToken
back_image: "/9j/4AAQSkZJR.......", //身份证国徽照
front_image: "/9j/4AAQSkZJR......", //身份证头像照
image_type: "BASE64", //身份证图片类型
score: 0.7063402088187446, //认证值
file: "new File()", //认证的资源文件
message: "pass" //状态码描述信息
}
- 当state传6时，返回示例
{
"state": 4,
"app_key": "***",
"auth_token": "***",
"idCard": "41***12",
"userName": "**",
"code": "201",
"message": "成功",
"result": {
"score": "99",
"image": "/9j/4AAQS......",
"match": "pass",
"desc": "比对成功"
}
}
三.返回码
| 状态码 | 状态描述 |
|---|
| 200 | 活体认证通过 |
| 201 | 人像对比通过 |
| 000500 | 参数错误 |
| 000510 | appKey 必填 |
| 000520 | authToken 必填 |
| 000600 | 动作获取失败 |
| 0006xx | 默认动作调用失败 |
| 0007xx | 自定义动作调用失败 |
| 000900 | 取消认证 |
| 000901 | 检测超时 |
| 000902 | 人像对比失败 |
| 000903 | 获取相机权限失败 |
没有更多了
