人证对比

服务说明

[!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}

results matching ""

    No results matching ""