产品详情
API参数 人脸身份证比对 调用地址: http,https://jmidcardface.api.bdymkt.com/idcard-face/validate 请求方式: POST 支持格式: application/json;charset=UTF-8 调用工具: 去调试 请求参数（Headers） 请求参数（Query）
- 名称
- 类型
- 是否必须
- 示例值
- 描述
- name
- string
- true
- null
- 姓名
- idCardNo
- string
- true
- null
- 身份证号
- facePhotoUrl
- string
- false
- null
- 人脸照片地址，facePhotoBase64必须提供一个
- 名称
- 类型
- 是否必须
- 示例值
- 描述
- facePhotoBase64
- string
- false
- --
- 人脸照片base64字符串，facePhotoBase64必须提供一个
<dependency>
<groupId>com.baidubce</groupId>
<artifactId>api-explorer-sdk</artifactId>
<version>1.0.0</version>
</dependency>
import com.baidubce.http.ApiExplorerClient;
import com.baidubce.http.AppSigner;
import com.baidubce.http.HttpMethodName;
import com.baidubce.model.ApiExplorerRequest;
import com.baidubce.model.ApiExplorerResponse;
// 人脸身份证比对 Java示例代码
public class RequestDemo {
public static void main(String[] args) {
String path = "//idcard-face/validate";
ApiExplorerRequest request = new ApiExplorerRequest(HttpMethodName.POST, path);
request.setCredentials("您的 access key", "您的 secret key");
request.addHeaderParameter("Content-Type", "application/json;charset=UTF-8");
request.addQueryParameter("name", "");
request.addQueryParameter("idCardNo", "");
request.addQueryParameter("facePhotoUrl", "");
ApiExplorerClient client = new ApiExplorerClient(new AppSigner());
try {
ApiExplorerResponse response = client.sendRequest(request);
// 返回结果格式为Json字符串
System.out.println(response.getResult());
} catch (Exception e) {
e.printStackTrace();
}
}
}
点击复制代码
正常返回示例 {
"code": 200,
"taskNo": "568753443590770688", //本次请求号
"data":{
"score": 0.82, //比较结果分值，0-1之间的小数，参考指标只有 0.40以下 系统判断为不同人； 0.40-0.44 不能确定是否为同一人 ； 0.45及以上 系统判断为同一人
"msg": "系统判断为同一人", //比较结果的描述
"incorrect": 100 //比较结果返回码，见incorrect详解
}
}
incorrect字段详解
1、编号说明
100 比对成功
101 身份证号码姓名不一致
102 库中无此号
103 身份核验成功，数据非法
104 数据非法
106 人脸识别系统异常
107 照片质量不合格
108 上传图片文件过大
109 身份核验成功，库中无照片
110 身份核验成功，特征提取失败
111 身份核验成功，检测到多于一张人脸
112 身份核验成功，图片不合法
113 人像比对服务异常
2、103 身份核验成功，数据非法
公安已经进行了身份核验（姓名身份证号码一致），公安返回的错误:除库中无照片（109），特征提取失败（110），检测到多于一张人脸(111)，人脸识别系统异常(106)，图片不合法(112)以外的情况。
3、104 数据非法
公安未进行身份核验前图片校验，公安返回的错误:除照片质量不合格(107)，上传图片文件过大(108)，人像比对服务异常(113)以外的情况。
4、103、104区别
103证件号码一致，照片比对时报错；104未进行证件号校验，数据检验报错。
5、104、107区别
107检测到的公安错误；104未检测到的公安错误。
失败返回示例 {
"code": 400, //指返回码，并非http状态码
"msg": "入参错误，身份证号[idcard]格式错误"
}
错误码定义 - code
- message
- status
- 描述
- 400
- 参数错误
- 400
- 参数错误
- 500
- 服务商维护，请稍候再试
- 500
- 服务商维护，请稍候再试
- 501
- 官方维护，请稍候再试
- 500
- 官方维护，请稍候再试
- 999
- 其他，以实际返回为准
- 500
- 其他，以实际返回为准
