主题
联网核查
接口描述
通过传输姓名+身份证号码,验证客户在公安系统中是否存在
进行接口调用前,需要获取必要的token信息,可查看登录鉴权。 该接口为加密接口,可查看签名与加密方式配置加密秘钥,并对接口内容进行加密。
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-cweis/netCheck/checkCIdAndNameHeader如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| cId | 是 | String | 1-32 | 身份证号码 |
| cName | 是 | String | 1-32 | 姓名 |
| busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"cId":"500111200001019999",
"cName":"钟国梦"
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果,0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -flowId | Long | 1-64 | 交易流水ID(建议保存) |
返回示例:
{
"code":0,
"data":{
"flowId":999
},
"message":"核查通过,判断为同一人"
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 0 | 是 | 是 | 核查通过,判断为同一人 |
| 4201 | 否 | 是 | 联网核查成功,身份证号码与姓名不符 |
| 4202 | 否 | 是 | 联网核查成功,未查到本人 |
| 4110 | 否 | 否 | 参数异常 |
| 4203 | 否 | 否 | 系统错误,请重试 |