主题
人&证&公安三像核验
接口描述
通过传输姓名+身份证号码+身份证人像照片+活体抓拍的照片到本平台,平台将身份证人像照与活体抓拍的照片比对、活体抓拍的照片与公安系统人像比对,返回两个比对相似度,从而判断用户是否持本人身份证办理业务。
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-cweis/netCheck/checkFaceExNew/v2Header如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| cId | 是 | String | 1-32 | 身份证号码 |
| cName | 是 | String | 1-32 | 姓名 |
| img | 是 | String | 1-3000k | 活体图片(base64 编码),原始图片大小需要小于 3M; |
| idCardImg | 是 | String | 1-3000k | 身份证人像数据(base64 编码),原始图片大小需要小于 3M; |
| busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"cId":"500111200001019999",
"cName":"钟国梦",
"idCardImg":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | String | 1-8 | 返回结果,00000000表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -checkSame | boolean | 1 | 活体抓拍的照片与公安联网核查人像比对是否一致 |
| -idcardSame | boolean | 1 | 身份证人像照与活体抓拍的照片比对是否一致 |
| -same | boolean | 1 | 是否一致 |
| -flowId | Long | 1-64 | 交易流水ID(建议保存) |
返回示例:
{
"code": "00000000",
"message": "请求成功",
"data": {
"checkSame": true,
"idcardSame": true,
"same": true
}
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 核查通过,判断为同一人 |
| 00000100 | 否 | 是 | 核查通过,疑似为同一人 |
| 00000101 | 否 | 是 | 核查通过,判断为不同人 |
| 00000102 | 否 | 是 | 核查通过,照片质量不合格 |
| 00000103 | 否 | 是 | 核查通过,渠道无照片 |
| 00000200 | 否 | 是 | 核查失败,姓名和身份证不匹配 |
| 00000201 | 否 | 是 | 核查失败,未找到相关信息 |
| 00000300 | 否 | 否 | 请求参数错误 |
| 00000301 | 否 | 否 | 系统错误,请重试 |
| 00000302 | 否 | 否 | 渠道调用异常 |
| 00000303 | 否 | 否 | 服务到期 |
| 00000304 | 否 | 否 | 余额不足 |
| 00000305 | 否 | 否 | 试用账号赠送次数已用完 |
| 00000306 | 否 | 否 | 渠道配置错误 |