人证核验(含证件状态)
更新时间: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
}
错误码
请参考错误码说明文档。