身份证户籍状态核验

---

接口描述

通过传输姓名+身份证号，核验客户身份信息在公安系统是否真实有效，同时返回户籍状态。

进行接口调用前，需要获取必要的token信息，可查看登录鉴权。 该接口为加密接口，可查看签名与加密方式配置加密秘钥，并对接口内容进行加密。

请求说明

HTTP 方法:

POST

请求 URL：

/ai-cloud-cweis/netCheck/checkIdNameHjzt

Header如下：

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

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

请求参数：

参数名称	必填	数据类型	长度	参数描述
cId	是	String	1-32	身份证号码
cName	是	String	1-32	姓名
busFlowId	否	String	0-64	业务流水号，业务系统唯一序列号（对账用，建议传入）

请求示例：

{
    "cId":"500111200001019999",
    "cName":"钟国梦"
}

返回说明

返回参数：

返回值名称	数据类型	长度	描述
code	String	8	接口调用处理状态，00000000 表示调用成功
message	String	1-255	接口调用状态描述
data	Object	-	返回的数据
-flowId	String	1-64	交易流水 ID（建议保存）
-statusCode	String	1-8	状态码：0 验证一致、1 验证不一致
-statusMessage	String	1-64	状态描述
-hjzt	String	1-8	户籍状态编码：0 有效人口、1 无效
-hjztMessage	String	1-255	户籍状态描述

外层 code、message 仅表示接口调用状态

返回示例：

{
    "code":"00000000",
    "data":{
        "flowId":"975431371847688192",
        "hjzt":"0",
        "hjztMessage":"有效人口",
        "statusCode":"0",
        "statusMessage":"验证一致",
    },
    "message":"success"
}

错误码

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

码值	是否成功	是否计费	描述
00000000	是	是	success
00000300	否	否	参数异常
00000301	否	否	系统错误，请重试
00000302	否	否	渠道调用异常
80004200	否	否	身份证号不能为空
80004201	否	否	姓名不能为空
80004000	否	否	参数长度错误
90002006	否	否	busFlowId长度不能超过64