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

接口说明

该接口返回结果状态分以下两种：

• 认证不通过：表示确认身份证信息不一致，产品可驳回认证申请，不通过的原因可通过ReasonType字段获取。

• 认证通过：表示确认身份证信息完全一致，产品直接通过该认证申请。

鉴权说明

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

请求

请求地址

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

请求头

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

请求参数

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

名称	类 型	必填	最大长度	描述
name	String	是	32	用户真实姓名，以身份证上姓名为准
cardNo	String	是	18	用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X
dataId	String	否	64	数据标识，可传入用户标识等数据，便于数据查询

请求体示例

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

响应

响应结果

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

名称	类型	必须返回	描述
status	Number	是	认证结果，1-通过 2-不通过（原因见reasonType) 0-待定
reasonType	Number	否	原因详情 2-输入姓名和身份证号不一致 3-查无此身份证 4-身份证照片信息与输入信息不一致 7-结果获取失败，请重试
taskId	String	是	本次请求数据标识，可以根据该标识在控制台进行数据查询
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费

reasonType= 3，查无此身份证。由不可控的多种原因构成： 
（1） 现役或刚退役的军人；
（2） 刚上大学或刚毕业的大学生；
（3） 正在迁移户口或者近期迁移户口；
（4） 工作调动导致户口有迁移；
（5） 发生更名导致户口有变动；
（6） 地方向中心上传时数据缺失。
以上情况无法主动解决，核心库更新速度取决于各地方信息化程度。请接入方提前设计好降级方案，采用白名单、人工审核等方式帮助客户通过验证。

响应体示例

{
    "code": 200,
    "msg": "ok",
    "result": {
        "taskId": "079560a6c9f34783bdce47e168510038",
        "status": 2,
        "reasonType": 2,
        "isPayed": 1
    }
}

响应返回码

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