H5降级视频活体
2024.11.20 10:20:47
在H5活体检测浏览器不支持的情况下会自动降级,不需要单独接入。视频活体仅作为H5活体的降级机制。
通过页面引导,让客户上传3-5秒钟的眨眼视频,以此判断客户是否为活体真人。
视频活体开始前,需要您制作一个引导页引导客户进行相关操作,这部分页面由您完全自定义,下面是流程参考示例:
体验DEMO
接口说明
接入业务方通过上传动作视频完成活体检测。该接口返回结果状态分以下两种:
-
认证不通过:表示云端校验后活体检测不通过,不通过的原因可通过ReasonType字段获取。
-
认证通过:表示云端校验后活体检测成功。
若视频过大,传输时间会较长,视频活体的结果获取会较慢。建议您在产品设计上做异步审核流程,提升用户体验, 推荐两种异步方式:
- 用户先做视频活体检测,再进入表单填写界面。将等待结果的时间利用起来,让用户能做其他操作
- 给审核设置一个3-5分钟的等待时长,让客户稍后再回来查看结果。这个要求视频活体不作为核心验证流程
鉴权说明
易盾信息认证服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://verify.dun.163.com/v1/liveperson/h5/check |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由请求公共参数和请求业务参数两部分组成,通用参数见请求通用字段
名称 | 类 型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
actions | JSONArray | 是 | 18 | 枚举:3-张嘴 4-眨眼(目前仅支持一个动作) 参数传输格式如:["4"] |
actionVideos | JSONArray | 是 | 动作名称对应视频内容,如:["URL"](该字段不需要做签名) | |
videoType | Number | 是 | 4 | 视频传输方式: 1-URL(最大支持30MB) 2-BASE64(最大支持15MB,传输时勿带格式标签)推荐使用BASE64。若为境外服务器,请告知客服域名为您进行代理配置) |
needAvatar | String | 否 | 4 | 是否需要返回正面照(true表示需要返回,不传或者默认为false) |
dataId | String | 否 | 64 | 数据标识,可传入用户标识等数据,便于数据查询 |
请求体示例
actionVideos=["URL"]&videoType=2&version=v1&businessId=xxx×tamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
响应
响应结果
响应字段如下,响应通用字段已省略,详细见响应公共字段
参数名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
lpCheckStatus | Number | 是 | 检测结果,1-通过 2-不通过(原因见reasonType)3-查无结果 |
reasonType | Number | 否 | 原因详情,2-活体检测不通过,5-视频下载失败,请查看视频URL是否正确,7-检测超时或其他异常 10-疑似攻击,建议拦截 11-检测对象为未成年人 |
taskId | String | 是 | 本次请求数据标识,可以根据该标识查询数据最新结果 |
avatar | String | 是 | 活体检测抓取的头像正面照,请在72小时内下载存储,超期失效 |
isPayed | Number | 是 | 本次请求是否收费标识,1代表收费,0代表不收费 |
响应体示例
当认证成功时,输出示例如下:
{
"code":200,
"msg":"ok",
"result":{
"lpCheckStatus":"1",
"taskId":"079560a6c9f34783bdce47e168510038",
"reasonType":"1",
"picType":"1",
"avatar":"http://xxxxxxx",
"isPayed": 1
}
}
响应返回码
响应返回码见:响应返回码