接口描述

针对营业执照图片，进行OCR检测，返回检测到的统一社会信用代码，注册号，名称，类型，住所，法定代表人，注册资金，成立日期，营业期限，实收资本。

请求方法

POST

接口要求

• 图片格式限制：图片格式支持 png、jpg、jpeg、bmp格式
• 图片大小限制：单张图片大小不超过 7MB
• 图片尺寸限制：图片像素尺寸应不小于 32x32，不大于 5000x5000

URI

/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json

请求参数

1.请求头header参数

2.请求体body参数

请求代码示例

Curl -X POST "https://ai-global.ctapi.ctyun.cn/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"Action": "BusinessCardOCR","ImageData": "9j_4AAQSkZJRgABAQAAAQABAAD_4QAwRXhpZgAATU0AKgAAA..."}'

返回值说明

1.请求成功返回响应参数

表returnObj

表detail

2.请求失败返回响应参数

返回值示例

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"
}

状态码

错误码说明

6 位错误码。4 开头为业务错误码，5 开头为服务错误码。全局请求返回错误码请参考章节API概览​>状态码

base64 编码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64encode() 函数进行编码
• java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码