人证对比
接口说明
[!NOTE]
上传人脸图片+姓名+身份证号与公安库留存的个人证件照信息进匹配。
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/baseservice/faceimgMatchId2factor #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
faceImg | file | ? | 人脸图片,图片大小100KB以内,格式:.jpg/.jpeg/.png | |
idcard | string | * | 身份证号 | |
name | string | * | 姓名 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("name","易XX");
params.put("idcard","500240XXXXXXXXXXXXXXX");
params.put("faceImg",new File("d:\\\\tmp\\\\20210331194706.jpg"));
ResultInfo<Void> ri= requestUtils.doPost("/v2/baseservice/faceimgMatchId2factor",params);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
data | string | * | 对比结果 |
[!NOTE]
data字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
seqNum | string | * | 处理序列号 |
message | string | * | 处理消息 |
matchResult | string | ? | 匹配结果1000:匹配一致 1001匹配不一致 1002:未匹配到信息 |
matchMessage | string | ? | 匹配消息 |
matchScore | string | ? | 匹配分数0-100 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"matchMessage":"身份信息有效,同一人","matchResult":"1000","matchScore":"89","message":"成功","seqNum":"tc7621033100334991"},"success":true}
//错误响应:
{"data":{"message":"入参错误,身份证号[idcard]格式错误","seqNum":"tc7421033100334026"},"success":true}