身份证识别

服务说明

[!NOTE] 君子签提供OCR身份证识别,通过上传身份证照片识别用户姓名和身份证号。该接口涉及到OCR识别费用,如果未购买需要联系商务进行购买。

http请求方式

[!NOTE] POST multipart/form-data

http请求地址

[!NOTE] $SERVICE_URL/v2/ocr/ocrIdentity #其中$SERVICE_URL为生产或测试的地址

http请求参数

参数 类型 是否必填 默认值 说明
file file ? 图片file,图片不能超2mb,图片分辨率不能超4k,file和imgHttpUrl有且只有一个上传
imgHttpUrl string ? 图片url地址(规范的url地址),图片不能超2mb,图片分辨率不能超4k
isCompress string ? 是否进行图片压缩(是0,否1,如果不压缩图片则可能会影响识别效率),默认为00
front int ? 1 0,识别身份证国徽面;1,识别身份证人像面

代码实现

JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("file", new FileBody(new File("/tmp/bank.png")));//也可用FileBody
//params.put("isCompress",0);
ResultInfo<Map<String,Object>> ri= requestUtils.doPost("/v2/ocr/ocrIdentity",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "file" => new CURLFile('D:/tmp/iden.png',null,"test.png"),
    "isCompress" => 0 //0压缩1不压缩,默认0
    //"imgHttpUrl" => "http://xxx.xxx.xxx"
);
//发起请求
$response=$requestUtils->doPost("/v2/ocr/ocrIdentity",$request);

http返回参数

[!NOTE] 返回response为application/json的数据,其字段说明如下

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode int * 成功0,其它参考附录
data object ? 业务信息

[!NOTE] data字段说明如下

参数 类型 是否必返回 说明
address string ? 户籍地住址(上传人像面时必返)
birthday string ? 出生日期(上传人像面时必返)
gender string ? 性别(上传人像面时必返)
idNo string ? 身份证号码 (上传人像面时必返)
name string ? 姓名(上传人像面时必返)
nation string ? 民族(上传人像面时必返)
issuingAuthority string ? 发证机关(上传国徽面时必返)
issuingTime string ? 有效期开始时间(上传国徽面时必返)
overdueTime string ? 有效期结束时间(上传国徽面时必返)
orderNo string * 流水号
executeStatus int * 执行状态(0:success;1:fail)
resultMessage instringt * 返回信息
resultCode string * 返回错误码

[!NOTE] 返回结果,参考:

//上传人像面正确响应:
{"data":{"address":"湖南省祁阳县浯溪镇人民东路301号","birthday":"19490117","executeStatus":0,"gender":"男","idNo":"43293XXXXXX70XXX","name":"蒋继凤","nation":"汉","orderNo":"85C5E62A220441A28E3B041D14166DB5","resultMessage":"success"},"success":true}
//上传国徽面正确响应:
{"data":{"executeStatus":0,"issuingAuthority":"重庆市公安局涪陵分局","issuingTime":"20101117","orderNo":"086F75BBFAA749EFA43CED6184FF82FC","overdueTime":"20201117","resultMessage":"success"},"success":true}

//错误响应:
{"msg":"没有识别到身份证","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

    No results matching ""