H5降级视频活体

2024.11.20 10:20:47

    H5活体检测浏览器不支持的情况下会自动降级,不需要单独接入。视频活体仅作为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 数据标识,可传入用户标识等数据,便于数据查询

    请求体示例

    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
       }
    }
    

    响应返回码

    响应返回码见:响应返回码

    在线咨询 电话咨询:95163223 免费试用