主题
身份证四要素核验
接口描述
通过传输姓名+身份证号+有效期开始时间+有效期结束时间,核验身份证信息状态。
请求说明
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 | int | 1-8 | 返回结果,0表示成功 |
message | String | 1-255 | 返回码描述 |
data | Object | - | 返回的数据 |
-flowId | String | 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 | 否 | 否 | 渠道调用异常 |