营业执照识别
更新时间 2026-06-01 09:32:08
最近更新时间: 2026-06-01 09:32:08
介绍如何调用营业执照识别能力。
接口描述
针对营业执照图片,进行OCR检测,返回检测到的统一社会信用代码,注册号,名称,类型,住所,法定代表人,注册资金,成立日期,营业期限,实收资本。
请求方法
POST
接口要求
图片格式限制:图片格式支持 png、jpg、jpeg、bmp格式
图片大小限制:单张图片大小不超过 7MB
图片尺寸限制:图片像素尺寸应不小于 32x32,不大于 5000x5000
URI
/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json
请求参数
1.请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | json格式 | application/json | |
| Authorization | 是 | String | 平台应用APIkey | Bearer $API_KEY |
2.请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Action | 是 | String | 请求参数放置于http body中,action代表需要请求的具体算法,只能为"BusinessCardOCR" | BusinessCardOCR | |
| ImageData | 是 | String | 一张图像Base64编码数据string。图片需要使用常规safe base64编码方式,不包含前缀"data:img/jpg;base64," |
请求代码示例
Curl -X POST "https://${host}/${api}/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json"
-H "Content-Type: application/json"
-H "Authorization: Bearer $API_KEY"
--data '{"Action": "BusinessCardOCR","ImageData": "9j_4AAQSkZJRgABAQAAAQABAAD_4QAwRXhpZgAATU0AKgAAA..."}'返回值说明
1.请求成功返回响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 返回状态,返回0表示成功,返回错误代码参考下面的错误代码列表 | 0 | |
| message | 是 | String | 如果statusCode为0,返回success;如果statusCode非0,则返回对应的可读错误信息 | success | |
| returnObj | 是 | Object | 识别的结果字典,字典内包营业执照的整体判断信息以及统一社会信用代码、名称、住所等详细键值对信息 | returnObj |
表returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| license_type | 是 | String | 营业执照的整体判断信息,'Business License'表示图片是营业执照,'Not Business License'表示图片不是营业执照 | Business License | |
| detail | 是 | Object | 返回结果键值集合,包含统一社会信用代码、名称、住所等信息 | - | detail |
表detail
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| union_id | 否 | String | 统一社会信用代码 | - | |
| regist_no | 否 | String | 注册号,三合一之前为注册号 | - | |
| name | 否 | String | 名称 | - | |
| type | 否 | String | 类型 | - | |
| addr | 否 | String | 住所 | - | |
| legal_rep | 否 | String | 法定代表人 | - | |
| regist_captial | 否 | String | 注册资金 | - | |
| establish_date | 否 | String | 成立日期 | - | |
| operation_period | 否 | String | 营业期限 | - | |
| real_captial | 否 | String | 实收资本(检测到双列营业执照返回此项,单列营业执照无此项信息) | - | |
| composing_form | 否 | String | 组成形式 | - | |
| serial_number | 否 | String | 编号 | - | |
| business_scope | 否 | String | 经营范围 | - | |
| national_emblem | 否 | Boolean | 是否有国徽。false为没有,true为有 | - | |
| qr_code | 否 | Boolean | 是否有二维码。false为没有,true为有 | - | |
| seal | 否 | Boolean | 是否有印章。false为没有,true为有 | - | |
| is_duplication | 否 | Boolean | 是否为副本。false为非副本,true为副本 | - |
2.请求失败返回响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 错误码,参见本文档错误码说明部分 | 400010 | |
| message | 是 | String | 返回对应的错误信息 | Action值设置错误 | |
| details | 是 | String | 返回对应的错误描述 | Action值设置错误 | |
| error | 是 | String | 返回对应的错误码 | AI_OP_400010 |
返回值示例
1.请求成功返回值示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"license_type": "Business License",
"detail": {
"union_id": "",
"regist_no": "32050XXXXXX8749",
"name": "苏州市XXXX有限公司",
"type": "有限公司(自然人控股)",
"addr": "苏州市相城区XXXXXXXXX",
"legal_rep": "潘X",
"regist_captial": "200万元人民币",
"establish_date": "2005年6月9日",
"business_scope": "一般经营项目XXXXXXXXX",
"national_emblem": true,
"qr_code": true,
"seal": true,
"is_duplication": true,
"operation_period": "2005年06月09日至2015年06月08日",
"real_captial": "200万元人民币",
"composing_form": "",
"serial_number": ""
}
}
}2.请求失败返回值示例
{
"statusCode": 400010,
"message": "Action值设置错误",
"details": "Action值设置错误",
"error":"AI_OP_400010"
}状态码
| http状态码 | 描述 |
|---|---|
| 200 | 表示请求成功 |
错误码说明
6 位错误码。4 开头为业务错误码,5 开头为服务错误码。
| 错误码 | 错误信息 | 错误描述 |
|---|---|---|
| CTAPI_10000 | API Not Found | |
| CTAPI_0009 | 无效json的body参数 | |
| AI_OP_400005 | 请求体类型错误 | 请求体需为字典,不能为其他类型 |
| AI_OP_400006 | 必传的参数未传 | 必须的参数('Action'、'ImageData')未传 |
| AI_OP_400008 | 请求体的字段类型错误 | Action字段值为string类型 ImageData 字段值为string类型 |
| AI_OP_400009 | 请求体的参数字段值为空 | Action字段值为空字符 ImageData 字段值为空字符 |
| AI_OP_400010 | 请求体的参数字段值设置错误 | Action 值设置错误 |
| AI_OP_400011 | base64 数据处理异常 | ImageData 字段的 base64 字符串转换字节码异常 |
| AI_OP_400012 | 请求文件格式不合法 | 仅支持 jpeg/png/jpg/bmp 格式 |
| AI_OP_400013 | 图片文件大小不符合要求 | 该文件大小不符合要求,静态图片要求小于7M |
| AI_OP_410001 | 图片解码错误 | 字节码解码为图片错误 |
| AI_OP_410002 | 图片尺寸不符合要求 | 分辨率长宽尺寸应不高于5000不低于32 |
| AI_OP_500001 | 服务接口异常,请联系管理员 | 需要联系管理员处理 |
base64 编码规则:使用常规的 safe base64 编码方式
python 中推荐使用
base64.urlsafe_b64encode()函数进行编码java 中推荐使用
BASE64.getUrlEncoder().encodeToString()函数进行编码