Skip to content

联网核查(特殊证件)


接口描述

通过传输姓名+证件号码,验证客户在公安系统中是否存在。支持的证件类型包括中国公民护照、港澳居民来往内地通行证、港澳居民来往内地通行证(非中国籍)、台湾居民来往内地通行证、外国人永久居留证。

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-cweis/netCheck/special/checkIdName

Header如下:

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

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

请求参数:

参数名称必填数据类型长度参数描述
cIdString1-32身份证号码
cNameString1-32姓名
typeString1-32证件类型(414:支持中国颁发、定居国外的中国公民护照(华侨护照),516:港澳居民来往内地通行证,511:台湾居民来往大陆通行证,553:外国人永久居留证,526:港澳居民来往内地通行证 (非中国籍))
nationString1-32国籍(三字码,如:中国,三字码为:CHN)
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "cId":"500111200001019999",
    "cName":"钟国梦",
    "type":"414",
    "nation":"CHN"
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeString1-8返回结果,00000000表示成功
messageString1-255返回码描述
dataObject-返回的数据
-flowIdString1-64交易流水ID(建议保存)
-busFlowIdString1-64传入的业务流水号

返回示例:

{
    "code":"00000000",
    "data":{
        "flowId":"999",
        "busFlowId":"123"
    },
    "message":"success"
}

返回CODE码表:

码值是否成功是否计费描述
00000000核查通过,判断为同一人
00000241核查通过,身份信息不一致
00000247核查通过,证件失效
00000300请求参数错误
00000301系统错误,请重试
00000302渠道调用异常
00000303服务到期
00000304余额不足
00000305试用账号赠送次数已用完
00000306渠道配置错误