H5端集成文档
更新时间：2026-09-04 16:56:53
一、准备工作
1、概述
本文是活体检测SDK_WEB（H5） 端接入文档，用于指导 SDK 的集成使用。
2、创建应用
在创蓝平台注册账号，创建应用并获取 appId 和 appkey
3、开发环境搭建
- 在页面中引入实人认证Web SDK的JS文件与CSS文件，以V2.0.2版本为例：
<script src="https://static2.253.com/wanshu/sdk/shiren/living2.0.2.min.js"></script>4、快速体验 demo
- 我们提供了一个 web 页面的【demo示例】，通过示例可以体验H5版本的基本用法。
5、注意事项
- app内嵌H5时，如果用户拒绝授权相机权限需要用户卸载重装app才能重新唤起授权弹框
二、API调用
0. 获取authToken
- 请查看服务端集成文档，调用获取授权Token（authToken）接口，获取authToken为后续步骤做准备。
1、 活体检测
【 方法调用说明 】
jmliving({ appKey: '***', authToken: '***' }, function (data) {
console.log('data', data);
});【 参数说明 】
| 参数名称 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|
| appKey | String | 是 | 在 统一平台应用管理列表中查看 (对应appId) |
| authToken | String | 是 | 由后端获取authToken接口获得 |
| actionsCount | Number | 否 | 动作数量，枚举值：1,2,3 默认值：2 |
| state | Number | 否 | 认证流程 1、身份证 2、活体检测，默认值：1 |
| okText | String | 否 | 默认值："确定" |
| cancelText | String | 否 | 默认值："取消" |
【 接入示例 】
- 返回示例：
{
"app_key": "WuH3...", // 应用密钥标识
"auth_token": "4910...", // 认证令牌authToken
"code": "200",// 响应码（成功）
"file": {}, // 文件信息（空）
"score": 0.6134156665267778,// 置信度分数
"message": "pass" // 活体检测状态消息（通过）
}2、返回码
| 状态码 | 状态描述 |
|---|---|
| 200 | 活体认证通过 |
| 201 | 人像对比通过 |
| 000500 | 参数错误 |
| 000510 | appKey 必填 |
| 000520 | authToken 必填 |
| 000600 | 动作获取失败 |
| 0006xx | 默认动作调用失败 |
| 0007xx | 自定义动作调用失败 |
| 000900 | 取消认证 |
| 000901 | 检测超时 |
| 000902 | 人像对比失败 |
| 000903 | 获取相机权限失败 |
这篇文档对您有帮助吗？
