人脸身份证比对,我们致力于为用户提供专业的免费API数据接口服务
核验姓名和身份证号是否一致,并判断人脸照片是否为身份证本人(返回分值作为判断依据)
https://api.shuliancloud.com/v4/face_id_card/compare
https://api.shuliancloud.com/v4/face_id_card/compare
点击右侧按钮复制完整请求地址,参数值请替换为实际有效值
| 参数名 | 是否必填 | 参数类型 | 参数说明 |
|---|---|---|---|
| 暂无请求参数信息 | |||
| 名称 | 类型 |是否必填 | 说明 | | ------------ | ------------ | ------------ | ------------ | | appid | varchar | 是 | 服务商分配的唯一标识 | | timestamp | number | 是 | 当前时间的毫秒数 | | sign | varchar | 是 | 签名,<a href='#sign'>签名算法说明</a> | | idcard | varchar | 是 | 身份证号码 | | name | varchar | 是 | 姓名 | |image |varchar| 否 | 图片base64字符串,image、url二选一| | url | varchar | 否 | 图片url,image、url二选一|
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| 暂无返回参数信息 | ||
| 字段名 | 说明 | | ------------ | ------------ | | success | 接口请求成功标识,true为成功,false为失败,失败情况下,会有对应描述和状态码 | | code |成功为200,其它为失败状态码 | | msg | code对应的说明描述 | | data | 验证结果详细信息| | order_no | 订单号| | score | 比较结果分值,0-1之间的小数,参考指标只有 0.40以下 系统判断为不同人; 0.40-0.45 不能确定是否为同一人 ; 0.45以上 系统判断为同一人| | msg | 比较结果的描述 |incorrect|比较结果返回码,见详解 |sex | 性别 |birthday | 生日 |address| 籍贯 ### incorrect字段详解 | 返回码 | 描述 |是否收费 |----------|------|----- |100 |比对成功 |是 |101 |身份证号码姓名不一致 |是 |102 |库中无此号 |是 |103 |身份核验成功,数据非法| 是 |104 |数据非法 |否 |106 |人脸识别系统异常 |否 |107 |照片质量不合格 |否 |108 |上传图片文件过大 |否 |109 |身份核验成功,库中无照片 |是 |110 |身份核验成功,特征提取失败 |是 |111 |身份核验成功,检测到多于一张人脸 |是 |112 |身份核验成功,图片不合法 |是 |113 |人像比对服务异常 |否 #### 103 身份核验成功,数据非法 公安已经进行了身份核验(姓名身份证号码一致),公安返回的错误:除库中无照片(109),特征提取失败(110),检测到多于一张人脸(111),人脸识别系统异常(106),图片不合法(112)以外的情况。 #### 104 数据非法 公安未进行身份核验前图片校验,公安返回的错误:除照片质量不合格(107),上传图片文件过大(108),人像比对服务异常(113)以外的情况。 #### 103,104区别 103证件号码一致,照片比对时报错;104未进行证件号校验,数据检验报错。 #### 104,107区别 107检测到的公安错误;104未检测到的公安错误。
{
"msg": "成功",
"success": true,
"code": 200,
"data": {
"order_no": "673106944390729728",
"score": 0.86,
"msg": "系统判断为同一人",
"incorrect": 100,
"sex": "男",
"birthday": "19930123",
"address": "江西省吉安地区遂川县"
}
}