对活体检测、实人认证能力进行组合，让用户身份核实更加快速，并通过权威数据源确保验证活体的人和身份证为同一个人。

接口说明

该接口是视频活体检测后端接口+实人认证接口的整体封装。
只需调用该接口即可完成视频活体+实人认证的双重校验。
该接口不会自动开通，若您需要，请联系客服开启。
视频活体检测详细介绍

鉴权说明

易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/liveperson/h5/audit
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

参数名称	类 型	必填	最大长度	描述
cardNo	String	是	18	用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X
name	String	是	32	用户真实姓名，以身份证上姓名为准
videoType	Number	是	4	视频传输方式： 1-URL（最大支持30MB） 2-BASE64（编码后大小不超过8M，支持mp4、avi、flv格式，传输时勿带格式标签）
actions	JSONArray	是	32	0-静默 4-眨眼 参数传输格式如：["0"]
actionVideos	JSONArray	是		对应视频内容,如：["URL"]["Base64"]（该字段不需要做签名）
needAvatar	String	否	4	是否需要返回正面照（true表示需要返回，不传或者默认为false）
dataId	String	否	64	数据标识，可传入用户标识等数据，便于数据查询

请求体示例

name=张三&cardNo=341622123456784317&videoType=1&actionVideos=["URL"]&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

响应

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

参数名称	类型	必须返回	描述
status	Number	是	最终结果，1-通过（活体+姓名身份证号+人脸比对全部通过） 2-不通过 0-待定
faceMatched	Number	是	权威数据源人脸比对是否通过，1-通过 2-不通过 0-待定
similarityScore	Number	是	权威数据源人脸照与身份证头像的相似度得分，未检测为-1，正常检测取值范围为0-1，相似度越高，分值越大。默认判断阈值为0.851（faceMatched字段采用此阈值，可自定义该阀值）
reasonType	Number	否	原因详情 2-活体通过，姓名身份证号一致，人脸比对非同一人 3-活体通过，姓名身份证号不一致 4-活体不通过 5-活体检测超时或出现异常 6-活体通过，查无此身份证 7-活体通过，库中无此身份证照片 8-活体通过，人脸照过大 9-活体通过，权威数据源出现异常 10-疑似攻击，建议拦截 11-检测对象为未成年人
taskId	String	是	本次请求数据标识，可以根据该标识查询数据最新结果
picType	Number	是	正面照图片类型：1-URL
avatar	String	是	活体检测抓取的头像正面照,请在72小时内下载存储，超期失效
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费

响应返回码

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