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

接口说明

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

客户端接入参看交互式活体SDK及插件下载

⚠️ 接入人脸核身注意事项：

1. 请根据实际开发环境选择人脸核身的业务类型（H5/APP）。
2. 确保客户端（活体检测部分）和服务端（后端接口）接入使用相同的人脸核身业务ID。

鉴权说明

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

请求

请求地址

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

请求头

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

请求参数

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

名称	类 型	必填	最大长度	描述
cardNo	String	是	18	用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X
name	String	是	32	用户真实姓名，以身份证上姓名为准
token	String	是	32	SDK认证通过的token，唯一标记一次活体检测，有效期20分钟
needAvatar	String	否	4	是否需要返回正面照（true表示需要返回，不传或者默认为false）
picType	String	否	4	1-URL，2-BASE64。用于设置avatar和actionImages的返回方式，不传默认为URL
dataId	String	否	64	数据标识，可传入用户标识等数据，便于数据查询

请求体示例

name=张三&cardNo=341622123456784317&token=xxx&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

响应

响应结果

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

名称	类型	必须返回	描述
status	Number	是	最终结果，1-通过（活体+姓名身份证号+人脸比对全部通过） 2-不通过（原因见reasonType）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，2-BASE64
avatar	String	是	活体检测抓取的头像正面照,请在72小时内下载存储，超期失效
actionImages	List	否	活体检测抓取的动作照。仅支持客户端SDK 2.2.1及以上版本返回。请在72小时内下载存储，超期失效
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费

响应体示例

{
    "msg":"ok",
    "result":{
        "faceMatched":1,
        "picType":1,
        "actionImages":[

        ],
        "avatar":"http://xxxxxxx",
        "reasonType":1,
        "isPayed":1,
        "taskId":"00ef2cf2b41647aa9adbbef0f0da6793",
        "status":1,
        "similarityScore":0.9646657142857142
    },
    "code":200
}

响应返回码

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