/ocr/business_license

1.接口描述

该 API 用于识别营业执照图像上的文字信息，主要支持横竖两版、三证合一和五证合一。

  • 图片要求：
    1. 格式为 JPG（JPEG），BMP，PNG
    2. 宽和高大于 8px，小于等于 4000px
    3. 小于等于 1.5 MB，建议300k以内
  • 支持自动旋转图片方向：
    1. 上传的图片中包含有 exif 方向信息，先按此信息旋转、翻转后再进行识别
    2. 如果照片方向混乱且 exif 方向信息不存在或不正确，自动旋转方向并调整

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/ocr/business_license

2.请求参数

字段 类型 必需 描述
api_id string 是 API 账户
api_secret string 是 API 密钥
file file 见下方注释 需上传的图片文件，上传本地图片进行检测时选取此参数
url string 见下方注释 图片网络地址，采用抓取网络图片方式时需选取此参数
image_id string 见下方注释 图片的id，在云端上传过图片可采用此参数

请求参数 file,url与 image_id 必须选择其中的一个。

url 中含有不少特殊字符，若将 URL 放入 Query String 中则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。 目前支持 http/https 等协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。 参数 file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

字段 类型 说明
request_id string 本次请求的id
status string 返回状态，正常为 OK，其他值表示失败，详见错误码
image_id string 使用file、url方式上传图片返回的图片的云端id
result array of object 营业执照文字信息， status为OK时才返回，详见result 数组中字段的结构

result 数组中字段的结构为：

字段 类型 说明
code string 注册号 或 社会统一信用代码
name string 名称
type string 类型
address string 住所 或 经营场所
person string 法定代表人 或 经营者
capital string 注册资本
date string 成立时间
valid_period string 营业期限，若为长期或永久，则返回"29991231"
business string 经营范围
营业执照识别结果示例
{
    "result": {
        "date": "20160520",
        "capital": "50万人民币",
        "code": "914405************",
        "address": "汕头市龙湖区**************",
        "valid_period": "20260520",
        "business": "食品销售及网上销售;销售及网上销售:日用百货、针纺织品、服装鞋帽、服装服饰、皮革制品、装饰品、工艺美术品;汽车销售。",
        "person": "陈**",
        "name": "汕头市****有限公司",
        "type": "有限责任公司(自然人独资)"
    },
    "request_id": "TID2d431a6248914216a231bd6ee65f844e",
    "status": "OK",
    "image_id": "e8a201f4f4e44f6489fe9613ada23628"
}

4.错误码

状态码 status 字段 说明
400 ENCODING_ERROR 参数非UTF-8编码
400 DOWNLOAD_TIMEOUT 网络地址图片获取超时
400 IMAGE_ID_NOT_EXIST 图片不存在
400 CORRUPT_IMAGE 文件不是图片文件或已经损坏
400 DOWNLOAD_ERROR 网络地址图片获取失败
400 IMAGE_FILE_SIZE_TOO_BIG 图片体积过大
400 INVALID_IMAGE_FORMAT_OR_SIZE 图片大小或格式不符合要求
400 INVALID_ARGUMENT 请求参数错误，具体原因见 reason 字段内容
400 INVALID_BUSINESS_LICENSE 营业执照图片识别错误，非营业执照图片
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期，具体情况见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
404 NOT_FOUND 请求路径错误
500 OCR_SERVER_ERROR 识别服务器异常
500 INTERNAL_ERROR 服务器内部错误
输出样例
{
  "status": "INVALID_ARGUMENT",
  "reason": "must specify 'image_id', 'file' or 'url' argument",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/ocr/business_license?api_id=ID&api_secret=SECRET" \
  -F file=@/PATH/TO/IMAGE
  • HTTPie 样例
http -f POST "https://cloudapi.linkface.cn/ocr/business_license?api_id=ID&api_secret=SECRET" \
  file@/PATH/TO/IMAGE

results matching ""

    No results matching ""