Skip to content

身份证四要素核验


接口描述

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

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-cweis/netCheck/checkCardStatus

Header如下:

参数名称
Content-Typeapplication/json;charset=UTF-8

Body中放置请求参数,参数详情如下:

请求参数:

参数名称必填数据类型长度参数描述
cIdString1-32身份证号码
cNameString1-32姓名
beginDateString8有效期开始时间(yyyyMMdd)
endDateString8有效期结束时间(yyyyMMdd,长期输入 00000000)
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

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

返回说明

返回参数:

返回值名称数据类型长度描述
codeint1-8返回结果,0表示成功
messageString1-255返回码描述
dataObject-返回的数据
-flowIdString1-64交易流水ID(建议保存)
-isNewestString1证件是否最新(1 最新、0 非最新)
-isLostedString1证件是否挂失(1 挂失、0 非挂失)
-isExpiredString1证件是否过期(1 过期、0 非过期)
-hjztString1户籍状态(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渠道调用异常