身份证四要素核验

---

接口描述

通过传输姓名+身份证号+有效期开始时间+有效期结束时间，核验身份证信息状态。

请求说明

HTTP 方法:

POST

请求 URL：

/ai-cloud-cweis/netCheck/checkCardStatus

Header如下：

参数名称	值
Content-Type	application/json;charset=UTF-8

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

请求参数：

参数名称	必填	数据类型	长度	参数描述
cId	是	String	1-32	身份证号码
cName	是	String	1-32	姓名
beginDate	是	String	8	有效期开始时间（yyyyMMdd）
endDate	是	String	8	有效期结束时间（yyyyMMdd，长期输入 00000000）
busFlowId	否	String	0-64	业务流水号，业务系统唯一序列号（对账用，建议传入）

请求示例：

{
    "cId":"500111200001019999",
    "cName":"钟国梦",
    "beginDate":"20100101",
    "endDate":"20201231"
}

返回说明

返回参数：

返回值名称	数据类型	长度	描述
code	String	1-8	返回结果，00000000表示成功
message	String	1-255	返回码描述
data	Object	-	返回的数据
-flowId	Long	1-64	交易流水ID（建议保存）
-isNewest	String	1	证件是否最新（1 最新、0 非最新）
-isLosted	String	1	证件是否挂失（1 挂失、0 非挂失）
-isExpired	String	1	证件是否过期（1 过期、0 非过期）
-hjzt	String	1	户籍状态（0 有效、1 有效（户籍迁出，但未迁入）、2 无效（死亡、失踪、迁出、服 兵役、出国境定居、消除重复登记人口、冻结户口、重载注销等）

返回示例：

{
  "code": "00000000",
  "data": {
    "flowId": 975431371847688192,
    "hjzt": "0",
    "isExpired": "0",
    "isLosted": "0",
    "isNewest": "1"
  },
  "message": "success",
  "success": true
}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表

码值	是否成功	是否计费	描述
00000000	是	是	核查通过，判断为同一人
00000200	否	是	核查失败，姓名和身份证不匹配
00000201	否	是	核查失败，未找到相关信息
00000300	否	否	请求参数错误
00000301	否	否	系统错误，请重试
00000302	否	否	渠道调用异常