Skip to content

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


接口描述

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

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-cweis/netCheck/personImgCheck

Header如下:

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

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

请求参数:

参数名称必填数据类型长度参数描述
cIdString1-32身份证号码
cNameString1-32姓名
imgString1-3000k待处理图片(base64 编码),原始图片大小需要小于 3M;
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "cId":"500111200001019999",
    "cName":"钟国梦",
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeString1-8返回结果,详见返回CODE码表
messageString1-255返回码描述
dataObject-返回的数据
-scoredouble2,6比对分(0-100),最大两位小数
-channelMessageString1-511渠道返回信息
-positiveIntervalString1-32比对分肯定区间
-possibleIntervalString1-32比对分疑似区间
-negativeIntervalString1-32比对分否定区间
-flowIdString1-64交易流水ID(建议保存)
-busFlowIdString1-64传入的业务流水号

返回示例:

{
    "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渠道配置错误

是否仍需要帮助? 请保持联络!