Skip to content

身份证三要素核验 ​


接口描述 ​

通过传输姓名+身份证号码+待比对人像照片,验证客户身份信息及人像照片在公安系统是否真实有效。

进行接口调用前,需要获取必要的token信息,可查看登录鉴权。 该接口为加密接口,可查看签名与加密方式配置加密秘钥,并对接口内容进行加密。

请求说明 ​

HTTP 方法:

POST

请求 URL:

/ai-cloud-cweis/netCheck/personImgCheck/v2

Header如下:

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

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

请求参数:

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

请求示例:

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

返回说明 ​

返回参数:

返回值名称数据类型长度描述
codeString1-8返回结果,详见返回CODE码表
messageString1-255返回码描述
dataObject-返回的数据
-checkSameboolean1是否同一人
-flowIdLong1-64交易流水ID(建议保存)
-busFlowIdString1-64传入的业务流水号
-scoredouble2,6比对分(0-100),最大两位小数,相似度大于70时判断为同一人

返回示例:

{
    "code":"00000000",
    "data":{
        "flowId":1000067372003891111,
        "busFlowId":"123",
        "checkSame":true,
        "score":94.0
    },
    "message":"核查通过,判断为同一人"
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表

码值是否成功是否计费描述
00000000是是核查通过,判断为同一人
00000100否是疑似为同一人
00000101否是判断为不同人
00000102否是照片质量不合格
00000103否是渠道无照片
00000200否是姓名和身份证不匹配
00000201否是未找到相关信息
00000300否否请求参数错误
00000301否否系统错误,请重试
00000302否否渠道调用异常
00000303否否服务到期
00000304否否余额不足
00000305否否试用账号赠送次数已用完
00000306否否渠道配置错误
00000400否否触发撞库风险