稳定、快速的API服务

人脸身份证比对,我们致力于为用户提供专业的免费API数据接口服务

人脸身份证比对 v1.0

最后更新: 2026-09-02 12:12:08

核验姓名和身份证号是否一致,并判断人脸照片是否为身份证本人(返回分值作为判断依据)

按次计费(¥0.28/次) 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址:
https://api.shuliancloud.com/v4/face_id_card/compare
请求方式: POST
返回格式: JSON

调用统计

0
今日调用
0
总调用次数
请求示例 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": "江西省吉安地区遂川县"
    }
}