身份证识别

接口说明

[!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，如果压缩图片则可能会影响识别效率）,默认为0
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 string ? 异常时返回
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 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 ""