通过对比权威数据源，对用户上传的姓名、身份证号、头像照进行验证，判断是否为同一个人，返回对比结果。

接口说明

该接口主要包括两个功能，一是所传姓名身份证号码是否匹配，二是如果匹配会将身份证照片与上传照片进行比对，返回人脸相似度值。

• 身份证认证不通过会返回相应原因，包括信息不一致、查无此身份证等；

• 身份证认证通过后返回人脸相似度分值，可以根据业务需求划定阈值，拒绝分值较小的认证申请；

鉴权说明

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

请求

请求地址

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

请求头

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

请求参数

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

名称	类 型	必填	最大长度	描述
name	String	是	32	用户真实姓名，以身份证上姓名为准
cardNo	String	是	18	用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X
picType	Number	是	4	图片类型：1-URL，2-BASE64
avatar	String	是	256或130K	用户正面头像照 如picType为url，长度限制为256 如picType为BASE64，大小限制为大小130K BASE64编码中不应该包含换行符（\n或\r\n）和图片头（data:image/jpg;BASE64），可支持PNG、JPG、BMP图片文件，不支持GIF图片，为保证正常识别效果，请保证照片中包含用户清晰头像。
dataId	String	否	64	数据标识，可传入用户标识等数据，便于数据查询

请求体示例

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

响应

响应结果

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

名称	类型	必须返回	描述
status	Number	是	姓名身份证号认证结果，1-通过 2-不通过（原因见reasonType) 0-待定
faceMatched	Number	是	权威数据源人脸照和身份证照片比对，1-同一个人 2-非同一人 0-不确定 （status为1时存在，该字段为1最终结果才通过）
reasonType	Number	否	认证结果的详细返回，详情见下方返回码说明。
similarityScore	Double	是	权威数据源人脸照与身份证头像的相似度得分，未检测为-1，正常检测取值范围为0-1，相似度越高，分值越大。默认判断阈值为0.851（faceMatched字段即采用此阈值，可自定义该阀值）
taskId	String	是	本次请求数据标识，可以根据该标识在控制台进行数据查询
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费

reasonType返回码说明

返回码	描述文案	可能原因与处理建议
2	输入姓名和身份证号不一致	可能用户的信息有误或假信息，建议用户确认后重新操作
3	查无此身份证	可能是户口更名、户口迁移、军人等特殊状态导致，建议人工介入
7	其他错误	调用失败，请联系客服处理
8	人脸比对分数低于默认阈值	特殊场景下，建议您根据similarityScore字段自定义阈值
9	库中无此身份证照片	可能是权威库数据问题导致，若是初次办理身份证，同步时间可能较长，常见于18岁以下的用户。建议客服介入
10	人像照过大	BASE64限制为大小130K，请压缩图片后上传
11	人像照不合规	若照片中出现多人脸、非活体脸等特殊情况会返回此项。该项表明用户照片存在恶意破解行为，建议人工复审

响应体示例

{
    "code": 200,
    "msg": "ok",
    "result": {
        "status": 1,
        "taskId": "xxxxxxxxxxxxxx",
        "reasonType": 1,
        "similarityScore": 0.8,
        "isPayed": 1,
        "faceMatched": 1
    }
}

响应返回码

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