身份证与名字比对（含有效期核验）

更新时间：2022-12-12

身份证与名字比对（含有效期核验）接口

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

业务能力

验证用户输入的身份证号码、姓名、身份证有效期是否匹配，判断用户信息是否真实。

注意事项：

请求示例

HTTP方法：POST

URL参数：

参数	值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header：

参数	值
Content-Type	application/json

Body中放置请求参数，参数详情如下：

请求参数

参数	必选	类型	说明
name	是	string	姓名（注：需要是UTF-8编码的中文）
id_card_number	是	string	身份证号
start_date	是	string	身份证有效期起始日期：年月日8位数字完整传入（如20120422）；起始日期不得早于19840101（第一代身份证签发日期）
end_date	是	string	身份证有效期截止日期：年月日8位数字完整传入（如20170422） 1：截止日期应晚于起始日期5年以上（包含5年）； 2：有效期截止日期为 ”长期”时，须转换为“00000000”入参请求；

请求示例

{
	"name": "黄*杰",
	"id_card_number": "460200********1396",
	"start_date": "20160304",
	"end_date": "20260304"
}

返回参数

参数	类型	说明
error_code	number	错误码
error_msg	string	错误信息
log_id	number	日志id
result	object	认证返回的结果
+verify_status	number	认证状态字段 0：身份信息核验成功 1：身份信息无效，包含“身份证号与姓名不匹配”、“身份证号不存在”、“身份证有效期信息不匹配”、“身份证已挂失”4种情况

返回示例

{
    "result": {
        "verify_status": 0
    },
    "error_code": 0,
    "error_msg": "SUCCESS",
    "log_id": 1556870623987097460
}