在H5 JS SDK 接入遇到浏览器不支持的情况时，SDK 会自动降级为视频活体，不需要单独接入。视频活体仅作为 H5 活体检测的降级机制。 通过页面引导，让用户上传 3～5 秒的眨眼视频，以此判断用户是否为活体真人。 视频活体开始前，需要您制作一个引导页引导客户进行相关操作，这部分页面由您完全自定义，下面是流程参考示例：

体验DEMO

接口说明

接入业务方通过上传动作视频完成活体检测。该接口返回结果状态分以下两种：

• 认证不通过：表示云端校验后活体检测不通过，不通过的原因可通过ReasonType字段获取。

• 认证通过：表示云端校验后活体检测成功。

若视频过大，传输时间会较长，视频活体的结果获取会较慢。建议您在产品设计上做异步审核流程，提升用户体验， 推荐两种异步方式：

1. 用户先做视频活体检测，再进入表单填写界面。将等待结果的时间利用起来，让用户能做其他操作
   
2. 给审核设置一个 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	数据标识，可传入用户标识等数据，便于数据查询

请求体示例

actions=["4"]&actionVideos=["URL"]&videoType=2&version=v1&businessId=xxx&timestamp=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
   }
}

响应返回码

响应返回码见：响应返回码