身份证有效期核验接口文档

---

1.接口说明

名称	说明
协议	HTTPS POST
地址	https://api.cxlnk.com/api/identityVerify/personal
Accept	application/json
Content-Type	application/json;charset=utf-8

2.请求参数说明

响应 body 数据为 JSON 格式

列表	内容
accessKey	API调用账号（必填，String类型，从灿星云平台获取）
accessSecret	API调用密钥（必填，String类型，从灿星云平台获取）
cardCode	身份证号码（必填，String类型）
cardName	身份证姓名（必填，String类型）
beginDate	身份证开始时间（必填）
endDate	身份证到期时间（必填）

3.请求参数示例

{
 "accessKey": "NDYw*******",
 "accessSecret": "MDQyOTQ1OTM3*********************",
 "cardCode": "50011********8577X",
 "cardName": "测试",
 "beginDate": "20250301",
 "endDate": "20450301"
}
					

4.响应参数列表

列表	内容
code	状态码200则为成功
msg	状态说明
success	处理是否成功:取值范围 true，false
data	业务数据 如果失败则为空
+isLosted	证件是否挂失（1挂失、0非挂失）
+isNewest	证件是否最新（1最新、0非最新）
+isExpired	证件是否过期（1过期、0非过期）
+hjzt	户籍状态（0有效、1有效(户籍迁出，但未迁入）2无效（死亡、失踪、迁出、服 兵役、出国境定居、消除重复登记人口、冻结户口、重载注销等）

5.响应参数示例——对应成功上述请求示例，则响应报文格式示例该如下：

{
 "code": 200,
 "msg": "成功",
 "success": true,
 "data": { 
         "isLosted": "0",
         "isNewest": "1",
         "isExpired": "0",
         "hjzt": "0"
    }
}
						

6.响应参数示例——对应核验不成功上述请求示例，则响应报文格式示例该如下：

{
 "code": 200,
 "msg": "身份四要素信息不一致",
 "success": true,
 "data": ""
 }