营业执照识别
接口描述
用户通过发送HTTP Post请求方式提交数据至公有云服务器,服务器识别并返回json格式的识别结果。
接口说明
请求URL:http://api.exocr.com/ocr/v1/business_license
请求方式:HTTP Post
返回格式:json
Header
参数 | 值 |
---|---|
Content-Type | 使用二进制方式时,为multipart/form-data;使用base64和url方式时,为application/x-www-form-urlencoded |
请求参数
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
app_key | 是 | string | 请在控制台->我的应用中获取 |
app_secret | 是 | string | 请在控制台->我的应用中获取 |
image_base64 | 否 | string | 图像base64编码。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。 |
image_url | 否 | string | 图像url地址。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。 |
image_binary | 否 | data | 图像二进制。image_base64、image_url、image_binary三个参数中至少选择一个,读取优先级从前到后依次降低。如:同时选择了以上三个参数,则以image_base64图像为准。 |
调用示例
java(相关依赖库下载)
package com.exocr.httpclient;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import com.exocr.common.utils.HttpClientUtils;
public class Test {
public static void main(String[] args) throws FileNotFoundException {
/**
* base64
*/
//识别url
String url = "http://api.exocr.com/ocr/v1/business_license";
//设置请求参数
Map<String, String> params = new HashMap<String, String>();
params.put("app_key", "#####");
params.put("app_secret", "#####");
//设置识别图像base64编码
params.put("image_base64", "base64ImageStr");
//发送请求,得到识别结果
String result = HttpClientUtils.doPost(url, params);
System.*out*.println(result);
/**
* url
*/
//设置请求参数、识别图像url
params.put("app_key", "#####");
params.put("app_secret", "#####");
params.put("image_url", "imageUrl");
//发送请求,得到识别结果
result = HttpClientUtils.doPost(url, params);
System.*out*.println(result);
/**
* 二进制
*/
//设置请求参数
params.put("app_key", "#####");
params.put("app_secret", "#####");
//拿到本地图像,写入数据流
File file = new File("/Users/mac/logs/businessLicense.png");
InputStream in = new FileInputStream(file);
//设置数据流
Map<String, InputStream> streamMap = new HashMap<String, InputStream>();
streamMap.put("image_binary", in);
//发送请求,得到识别结果
result = HttpClientUtils.doPostStream(url, params, streamMap);
//关闭io流
try {
in.close();
} catch (IOException e) {
e.printStackTrace();
}
System.*out*.println(result);
}
}
返回示例
{
"result":{
"no":{
"chinese_key":"统一社会信用代码",
"words":"9111010823232336L",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"name":{
"chinese_key":"名称",
"words":"北京####科技有限公司",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"type":{
"chinese_key":"类型",
"words":"有限责任公司(自然人投资或控股)",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"address":{
"chinese_key":"住所",
"words":"北京市海淀区",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"representitive":{
"chinese_key":"法定代表人",
"words":"张三",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"capital":{
"chinese_key":"注册资本",
"words":"1000万元",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"found_date":{
"chinese_key":"成立日期",
"words":"2013年03月27日",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"expire_date":{
"chinese_key":"营业期限",
"words":"2013年03月27日至2033年03月26日",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
},
"business_scope":{
"chinese_key":"经营范围",
"words":"技术开发、技术服务、技术咨询、技术转让;计算机技术培训;数据处理;销售计算机、软件及辅助设备、通讯设备。(企业依法自主选择经营项目,开展经营活动;依法须经批准的项目,经相关部门批准后依批准的内容开展经营活动;不得从事本市产业政策禁止和限制类项目的经营活动。)",
"score":1,
"position":{
"width":0,
"top":0,
"height":0,
"left":0
}
}
},
"error_code":0,
"description":"识别成功",
"request_id":"58B8B8B3B33F40E1ADA4ABB4C3AB8EBF",
"recognize_time":3009,
"available_count":9942
}
返回说明
通用参数
参数 | 类型 | 说明 |
---|---|---|
result | array | 返回结果数组,包括所有字段的识别信息 |
error_code | int | 错误码,返回0为正确,其他为错误 |
description | string | 识别结果描述 |
request_id | string | 请求唯一标识符 |
recognize_time | int | 识别所用时间,单位为毫秒 |
available_count | int | 识别剩余可用次数,次数不足时无法继续识别,可在控制台进行充值次数 |
营业执照识别特有参数
参数 | 类型 | 说明 |
---|---|---|
words | string | 当前字段的值 |
score | float | 可信度(1.0为可信度100%) |
position | array | 当前字段在图像上的位置信息 |
left | int | 位置值,距离原图左侧距离x,单位为像素 |
top | int | 位置值,距离原图上方距离y,单位为像素 |
width | int | 位置值,字段所在图框宽度w,单位为像素 |
height | int | 位置值,字段所在图框高度h,单位为像素 |
chinese_key | String | 该字段中文含义 |
license_type | Object | 执照类型 |
reg_authority | Object | 登记机关 |
no | Object | 统一社会信用代码,注册号 |
representitive | Object | 法定代表人,法定代表人姓名,负责人,经营者,经营者姓名,投资人,执行事务合伙人,资人 |
name | Object | 名称,商事主体类型 |
type | Object | 公司类型,类型,企业类型,商事主体类型,主体类型 |
address | Object | 经营场所,营业场所,主要经营场所,住所 |
orgnazation_type | Object | 组成形式 |
found_date | Object | 成立日期,注册日期 |
business_scope | Object | 经营范围,业务范围 |
reg_date | Object | 登记日期 |