联网核查人像比对-2023新-服务


接口描述

联网核查人像比对是第三方系统上传客户身份证号码、姓名和待比对的人脸图片到本平台,平台根据身份证号码和姓名到公安系统联网核查获得公安人像数据,然后和待比对人脸图片进行人脸相似度比对,从而返回人像比对结果,人像比对相似度。 本接口能力与《新联网核查人像比对》相同,增加了明确的联网核查比对结果。如有新接入请务必使用此接口,同时使用老接口的也建议切换到此接口。

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-cweis/netCheck/personImgCheck

Header如下:

参数名称
Content-Type application/json;charset=UTF-8
Body中放置请求参数,参数详情如下: 请求参数:
参数名称 必填 数据类型 参数描述
appKey String 应用生成的appkey
sign String 签名
nonceStr String 随机字符串
cId String(1,32) 身份证号码
cName String(1,32) 姓名
img String(1,4000) Base64编码的活体抓拍的照片数据
busFlowId String(1,64) 业务流水号,业务系统唯一序列号(对账用,建议传入)

返回说明

返回参数:

返回值名称 类型 是否必传 描述
code String 成功与否唯一标志,00000000表示成功
message String 返回码描述
success boolean 调用是否成功
data Object 返回的具体描述信息
| score double 比对分(0-100),最大两位小数
| flowId String 平台交易流水ID(建议保存)
| channelMessage String 渠道返回信息
| positiveInterval String 比对分肯定区间
| possibleInterval String 比对分疑似区间
| negativeInterval String 比对分否定区间
| busFlowId String 传入的业务流水号

返回示例:

{
    "code":"00000000",
    "data":{
        "channelMessage":"身份证号与姓名匹配,照片系统判断为同一人",
        "flowId":"999",
        "busFlowId":"123",
        "negativeInterval":"[0,40)",
        "positiveInterval":"[60,100]",
        "possibleInterval":"[40,60)",
        "score":94.0
    },
    "message":"核查通过,判断为同一人",
    "success":true
}

返回CODE码表:

码值 是否成功 是否计费 描述
00000000 核查通过,判断为同一人
00000100 核查通过,疑似为同一人
00000101 核查通过,判断为不同人
00000102 核查通过,照片质量不合格
00000103 核查通过,渠道无照片
00000200 核查失败,姓名和身份证不匹配
00000201 核查失败,未找到相关信息
00000300 请求参数错误
00000301 系统错误,请重试
00000302 渠道调用异常
00000303 服务到期
00000304 余额不足
00000305 试用账号赠送次数已用完
00000306 渠道配置错误
是否仍需要帮助? 请保持联络!
最后更新于 23rd Apr 2024