主题
联网核查人像比对(特殊证件)
接口描述
通过传输姓名+证件号码+待比对人像照片,验证客户身份信息及人像照片在公安系统是否真实有效。支持的证件类型包括中国公民护照、港澳居民来往内地通行证、港澳居民来往内地通行证(非中国籍)、台湾居民来往内地通行证、外国人永久居留证。
请求说明
HTTP 方法:
POST
请求 URL:
/ai-cloud-cweis/netCheck/special/checkFace
Header如下:
参数名称 | 值 |
---|---|
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
---|---|---|---|---|
cId | 是 | String | 1-32 | 身份证号码 |
cName | 是 | String | 1-32 | 姓名 |
type | 是 | String | 1-32 | 证件类型(414:支持中国颁发、定居国外的中国公民护照(华侨护照),516:港澳居民来往内地通行证,511:台湾居民来往大陆通行证,553:外国人永久居留证,526:港澳居民来往内地通行证 (非中国籍)) |
nation | 是 | String | 1-32 | 国籍(三字码,如:中国,三字码为:CHN) |
img | 是 | String | 1-3000k | 待处理图片(base64 编码),原始图片大小需要小于 3M; |
busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"cId":"500111200001019999",
"cName":"钟国梦",
"type":"414",
"nation":"CHN",
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}
返回说明
返回参数:
返回值名称 | 数据类型 | 长度 | 描述 |
---|---|---|---|
code | String | 1-8 | 返回结果,详见返回CODE码表 |
message | String | 1-255 | 返回码描述 |
data | Object | - | 返回的数据 |
-flowId | String | 1-64 | 交易流水ID(建议保存) |
-busFlowId | String | 1-64 | 传入的业务流水号 |
返回示例:
{
"code":"00000000",
"data":{
"flowId":"999",
"busFlowId":"123"
},
"message":"success"
}
返回CODE码表:
码值 | 是否成功 | 是否计费 | 描述 |
---|---|---|---|
00000000 | 是 | 是 | 核查通过,判断为同一人 |
00000241 | 否 | 是 | 核查通过,身份信息不一致 |
00000242 | 否 | 是 | 核查通过,身份信息一致但证件失效 |
00000243 | 否 | 是 | 核查通过,身份信息一致但人像不一致 |
00000244 | 否 | 是 | 核查通过,身份信息一致但人像未找到 |
00000245 | 否 | 是 | 核查通过,身份信息一致但照片不合格 |
00000246 | 否 | 是 | 核查通过,其他信息不一致 |
00000247 | 否 | 是 | 核查通过,证件失效 |
00000300 | 否 | 否 | 请求参数错误 |
00000301 | 否 | 否 | 系统错误,请重试 |
00000302 | 否 | 否 | 渠道调用异常 |
00000303 | 否 | 否 | 服务到期 |
00000304 | 否 | 否 | 余额不足 |
00000305 | 否 | 否 | 试用账号赠送次数已用完 |
00000306 | 否 | 否 | 渠道配置错误 |