适用场景与接口能力边界在企业资质核验、合规审查、供应商管理、电商入驻审核等场景中经常需要从营业执照图片中自动化提取关键字段。本文介绍的营业执照识别 API 支持将 JPG/PNG 图片URL 或 base64 编码上传后返回统一社会信用代码、公司名称、法定代表人、准备资本、经营范围等 12 个字段。接口单次请求仅处理一张图片文件大小上限为 10 MB图片建议清晰完整无遮挡以保证识别精度。能力边界支持图片传入方式URL 或 base64base64 字符串最大 10 MB输出字段共 12 个详见下文返回值解读QPS2 次/秒超过后会返回限流错误延迟通常 1~3 秒视图片大小和网络而定鉴权与请求头调用前需准备 API Key。在请求时通过 HTTP 头Authorization传递格式为Bearer 你的 API Key。同时必须设置Content-Type为application/json。Authorization: Bearer sk-xxxxxxxxxxxxxxxx Content-Type: application/json请求参数详解请求体是单个 JSON 对象包含两个必填字段字段名类型必填说明input_typestring是图片传入方式固定值url或base64input_datastring是图片 URL 或 base64 编码字符串去掉 data:image/...;base64, 前缀示例使用 URL 传入{ input_type: url, input_data: https://example.com/business-license.jpg }示例使用 base64 传入{ input_type: base64, input_data: /9j/4AAQSkZJRgABAQAAAQABAAD/2wBD... }base64 编码需去掉前缀data:image/jpeg;base64,或data:image/png;base64,仅保留纯 base64 字符串。最小可运行示例curl以下命令是完整的可复制请求需替换$API_KEY与图片 URLcurl -sS \ -X POST \ -H Authorization: Bearer $API_KEY \ -H Content-Type: application/json \ -d { input_type: url, input_data: https://img.example.com/license.jpg } \ https://v1.apizero.cn/api/business-license将$API_KEY替换为真实的 API Keyinput_data替换为可访问的图片 URL 即可。如果希望更安全地传递环境变量也可以使用-H X-API-Key: $API_KEY具体鉴权方式以文档为准本例使用 Authorization Bearer 方式。Python 请求示例requests 库import requests import json url https://v1.apizero.cn/api/business-license headers { Authorization: Bearer YOUR_API_KEY, Content-Type: application/json } payload { input_type: url, input_data: https://img.example.com/license.jpg } response requests.post(url, headersheaders, jsonpayload) print(response.json())返回结果解读成功时 HTTP 状态码为 200响应体 JSON 如下{ code: 0, msg: 成功, request_id: req_abc123, data: { unified_social_credit_code: 91310000XXXXXXXXXX, company_name: 某某科技有限公司, legal_representative: 张三, registered_capital: 100万人民币, established_date: 2015-06-01, business_scope: 软件开发信息技术咨询服务, company_type: 有限责任公司自然人独资, domicile: 上海市浦东新区某某路123号, certificate_type: 营业执照, establishment_period: 2015-06-01至无固定期限, approval_date: 2025-01-10, website: http://www.gsxt.gov.cn } }各字段含义字段示例值说明unified_social_credit_code91310000XXXXXXXXXX统一社会信用代码18 位company_name某某科技有限公司企业全称legal_representative张三法定代表人姓名registered_capital100万人民币准备资本及币种established_date2015-06-01成立日期格式 yyyy-MM-ddbusiness_scope软件开发信息技术咨询服务经营范围分号分隔company_type有限责任公司自然人独资企业类型domicile上海市浦东新区某某路123号住所/准备地址certificate_type营业执照证件类型固定值establishment_period2015-06-01至无固定期限营业期限approval_date2025-01-10最近核准日期可能为空websitehttp://www.gsxt.gov.cn企业信用信息公示系统链接可选注意request_id是本次请求的唯一标识符可配合日志排查问题。code为 0 表示成功非 0 值见下文错误处理。常见错误码与排查要点错误现象可能原因处理方式HTTP 401 返回{code:401,msg:无效的 API Key}API Key 未传或错误检查Authorization头格式及 Key 有效性HTTP 403请求被拒绝可能是 IP 白名单限制确认请求源 IP 已加入白名单以文档为准HTTP 400 返回{code:400,msg:参数错误}input_type不是 url/base64或input_data为空校验请求体 JSON 格式及字段值HTTP 413 或返回图片过大图片超过 10 MB压缩图片或使用 URL 方式代替 base64base64 编码后体积增大约 37%返回code: 1001等业务错误码具体参见文档图片模糊、文字遮挡、非营业执照等更换清晰图片保持图像中无反光、倾斜当code不为 0 时msg会给出简要描述。建议读取request_id后联系技术支持时引用。工程化注意事项图片质量营业执照应占图片主体四角完整文字清晰。建议分辨率不低于 1024×768。格式优先使用 JPG平衡质量和文件大小。base64 转换时机如果 base64 图片来自前端上传后端接收后直接传给 API注意去掉 data URL 前缀data:image/jpeg;base64,否则 API 解析会失败。限流处理QPS 上限为 2建议在代码中加入退避重试机制如指数退避。对于批量场景如一次审核 100 张可以控制并发数≤2或使用队列逐步消费。字段校验返回的字段由 OCR 识别得到可能因图片质量问题导致个别字段为空或格式不标准。业务逻辑中应做空值判断不要假设所有字段都存在。例如approval_date可能为空。数据安全营业执照图片涉及企业隐私传输建议使用 HTTPSbase64 编码不应写入日志。API Key 应存储在环境变量或密钥管理服务中避免硬编码。缓存策略如果同一张图片需要多次识别例如前后两次查询可对图片的哈希值进行缓存减少重复请求。注意图片内容更新时应清除缓存。参考文档营业执照识别 API 文档原始文档raw markdown文档中包含完整的错误码列表、更多语言 SDK 示例及更新说明。
