读写身份证图片上的身份信息。
l 请求方式:POST
l 请求URL:请求地址/core/api/ocr_idcard?token=${token}
参数名 | 类型 | 可空 | 说明 |
idcard_img_base64 | String | 二选择一 都传选择文件 | 身份证图片(base64字符串) |
idcard_img_file | File | 身份证图片文件 |
注1:不能确定字段内容时,结果会是null或空;身份证并没有做逻辑校验(如:2月30日,身份证长度为15位等)
注2:识别算法在不确定的域中有可能返回星号,这个原因可能是由于身份证图片中某些域不太清晰或者模糊等情况导致的。因此对于这种情况,建议要求用户重新拍摄。
返回值是JSON格式的字符串数据。返回格式如:
参数名 | 类型 | 可空 | 说明 |
success | boolean | 否 | 核验结果 |
msg | String | 否 | 结果描叙 |
code | String | 否 | 结果编号 |
sign | String | 是 | 该字段是比对后将返回的code字段加调用者的clientkey做SHA1所生成,调用者和用同样的方法核验服务器 |
orderno | String | 是 | 该字段是接口核验所生成的业务单号 |
obj | Object | 是 | 该字段返回身份证的具体信息(JSON):{ birthday,side(注:front/back 表示身份证的人像面/国徽面)), address, name, gender, valid_date, type(证件类型。返回1,代表是身份证), race(注:民族(汉字)), id_card_number, issued_by(签发机关)} |