本文介绍文字识别(ocr)类目下的营业执照识别RecognizeBusinessLicense的语法及示例。
功能描述
营业执照识别能力可以识别营业执照关键字段内容,包括:公司地址、营业范围、注册资本、注册日期、公司法人、公司名称、统一社会信用代码、公司类型、公司营业期限日期。同时可以输出营业执照上二维码、印章位置。
接入指引
1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
2. 开通能力:请确保您已开通文字识别服务,若未开通服务请立即开通。
3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权。
4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。
5. 开发接入步骤:
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为文字识别(ocr)的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码:该能力常用语言的示例代码,请参见营业执照识别示例代码。
7. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:JPEG、JPG、PNG、BMP、GIF。
- 图像大小:不超过3 MB。
- 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
- 请求格式:JPEG、JPG、PNG、BMP、GIF。
计费说明
关于营业执照识别的计费方式及报价,请参见计费介绍。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeBusinessLicense | 系统规定参数。取值:RecognizeBusinessLicense。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeBusinessLicense/RecognizeBusinessLicense1.jpg | 图像URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | F34D031B-02BD-4A59-BA35-EE068DD6F6E6 | 请求ID。 |
Data | Object | 返回的结果数据内容。 |
|
Type | String | 有限责任公司 | 公司类型。识别失败时返回 |
Stamp | Object | 印章位置。识别失败时返回 |
|
Top | Integer | 1030 | 区域左上角y坐标。 |
Width | Integer | 154 | 区域宽度。 |
Height | Integer | 154 | 区域高度。 |
Left | Integer | 650 | 区域左上角x坐标。 |
EstablishDate | String | 20150504 | 公司注册日期。例如证件上为“2014年04月16日”,则接口返回“20140416”。 |
ValidPeriod | String | 29991231 | 公司营业期限终止日期。例如证件上为“2014年04月16日至2034年04月15日”,则接口返回“20340415”。 说明 当前算法将日期格式统一输出为“年月日”(例如“20391130”),并用“29991231”表示“长期”,若证件上没有营业期限,则默认其为“长期”返回“29991231”。 |
Business | String | 网络技术服务;网站建设;销售:I类医疗器械、保健用品(不含保健食品)等 | 经营范围。识别失败时返回 |
Angle | Float | 0 | 输入图片的角度(顺时针旋转)。枚举值包括:0、90、180、270。 |
RegisterNumber | String | 91500108320423**** | 统一社会信用代码。识别失败时返回 |
Address | String | 浙江省杭州市西湖区转塘科技经济区块888号888幢 | 公司地址。识别失败时返回 |
Capital | String | 壹百万元整 | 注册资本。识别失败时返回 |
Title | Object | 标题位置。识别失败时返回 |
|
Top | Integer | 10 | 区域左上角y坐标。 |
Width | Integer | 10 | 区域宽度。 |
Height | Integer | 10 | 区域高度。 |
Left | Integer | 10 | 区域左上角x坐标。 |
Emblem | Object | 国徽位置。识别失败时返回 |
|
Top | Integer | 8 | 区域左上角y坐标。 |
Width | Integer | 162 | 区域宽度。 |
Height | Integer | 163 | 区域高度。 |
Left | Integer | 366 | 区域左上角x坐标。 |
Name | String | 某某电子商务有限公司 | 公司名称。识别失败时返回 |
QRCode | Object | 二维码位置。识别失败时返回 |
|
Top | Integer | 914 | 区域左上角y坐标。 |
Width | Integer | 126 | 区域宽度。 |
Height | Integer | 132 | 区域高度。 |
Left | Integer | 156 | 区域左上角x坐标。 |
LegalPerson | String | 李四 | 公司法人。识别失败时返回 |
SDK参考
阿里云视觉AI文字识别类目下的营业执照识别能力推荐使用SDK调用,支持多种编程语言,调用时请选择AI类目为文字识别(ocr)的SDK包,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例代码
该能力常用语言的示例代码,请参见营业执照识别示例代码。
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeBusinessLicense //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeBusinessLicense/RecognizeBusinessLicense1.jpg
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>F34D031B-02BD-4A59-BA35-EE068DD6F6E6</RequestId>
<Data>
<ValidPeriod>29991231</ValidPeriod>
<Address>浙江省杭州市西湖区转塘科技经济区块888号888幢</Address>
<Stamp>
<Left>971</Left>
<Top>572</Top>
<Height>197</Height>
<Width>191</Width>
</Stamp>
<Title>
<Left>447</Left>
<Top>177</Top>
<Height>80</Height>
<Width>354</Width>
</Title>
<Capital>叁佰万元整</Capital>
<LegalPerson>李四</LegalPerson>
<EstablishDate>20150504</EstablishDate>
<Name>某某电子商务有限公司</Name>
<RegisterNumber>91500108320423****</RegisterNumber>
<Type>有限责任公司</Type>
<QRCode>
<Left>848</Left>
<Top>199</Top>
<Height>88</Height>
<Width>91</Width>
</QRCode>
<Angle>0</Angle>
<Emblem>
<Left>550</Left>
<Top>6</Top>
<Height>150</Height>
<Width>137</Width>
</Emblem>
<Business>网络技术服务;网站建设;销售:I类医疗器械、保健用品(不含保健食品);医药技术咨询(不含诊疗活动及药品销售)、健康知识及其信息咨询(不含诊疗活动)、健康管理咨询(不含诊疗活动)、医院管理咨询(不含诊疗活动及药品销售):健康保健项目策划、设计;化妆品、饰、工艺礼品(不含象牙及其制品)、家具护理用品、劳防用品的批发;货物进出口(法律、法规禁止的项目除外;法律、法规限制的项目取得许可后方可经营);品牌推广;旅游信息咨询;翻译服务;票务代理;设计、制作、代理、发布广告;会议及展览展示服务。(依法须经批准的项目,经相关部门批准后方可开展经营活动)</Business>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F34D031B-02BD-4A59-BA35-EE068DD6F6E6",
"Data" : {
"ValidPeriod" : 29991231,
"Address" : "浙江省杭州市西湖区转塘科技经济区块888号888幢",
"Stamp" : {
"Left" : 971,
"Top" : 572,
"Height" : 197,
"Width" : 191
},
"Title" : {
"Left" : 447,
"Top" : 177,
"Height" : 80,
"Width" : 354
},
"Capital" : "叁佰万元整",
"LegalPerson" : "李四",
"EstablishDate" : 20150504,
"Name" : "某某电子商务有限公司",
"RegisterNumber" : "91500108320423****",
"Type" : "有限责任公司",
"QRCode" : {
"Left" : 848,
"Top" : 199,
"Height" : 88,
"Width" : 91
},
"Angle" : 0,
"Emblem" : {
"Left" : 550,
"Top" : 6,
"Height" : 150,
"Width" : 137
},
"Business" : "网络技术服务;网站建设;销售:I类医疗器械、保健用品(不含保健食品);医药技术咨询(不含诊疗活动及药品销售)、健康知识及其信息咨询(不含诊疗活动)、健康管理咨询(不含诊疗活动)、医院管理咨询(不含诊疗活动及药品销售):健康保健项目策划、设计;化妆品、饰、工艺礼品(不含象牙及其制品)、家具护理用品、劳防用品的批发;货物进出口(法律、法规禁止的项目除外;法律、法规限制的项目取得许可后方可经营);品牌推广;旅游信息咨询;翻译服务;票务代理;设计、制作、代理、发布广告;会议及展览展示服务。(依法须经批准的项目,经相关部门批准后方可开展经营活动)"
}
}
错误码
关于营业执照识别的错误码,详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。