人证核验（含证件状态）
更新时间：2024-08-28
人证核验（含证件状态）接口
如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
能力介绍
业务能力
验证用户输入的身份证号码、姓名、身份证有效期是否匹配，判断用户信息是否真实。并返回当前用户证件、户籍状态，包括
- 证件状态：是否最新、是否挂失、是否过期
- 户籍状态：有效、暂时失效（户籍迁出，但未迁入）、无效（死亡、失踪、迁出、服兵役、出国境定居、消除重复登记人口、冻结户口、重载注销等
请求说明
注意事项：
- 请求体格式化：Content-Type为
application/json，通过json格式化请求体。
请求示例
HTTP方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/face/v4/idmatch_status
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：身份信息无效，包含“身份信息不存在”、“身份证号不存在”、2种情况。 |
| +isNewest | number | 证件是否最新，1 最新、0 非最新 |
| +isLosted | number | 证件是否挂失，1 挂失、0 非挂失 |
| +isExpired | number | 证件是否过期，1 过期、0 非过期 |
| +hjzt | number | 户籍状态，0有效、1暂时失效（户籍迁出，但未迁入）、2无效（死亡、失踪、迁出、服兵役、出国境定居、消除重复登记人口、冻结户口、重载注销等） |
返回示例
{
"result": {
"verify_status": 0
"isNewest": 1 //证件是否最新
"isLosted": 0 //证件是否挂失
"isExpired": 0 //证件是否过期
"hjzt": 0 //户籍状态
},
"error_code": 0,
"error_msg": "SUCCESS",
"log_id": 1556870623987097460
}错误码
请参考错误码说明文档。