适用场景与业务价值营业执照识别是企业在数字化转型中的高频需求。当你在以下场景中遇到需要提取营业执照信息时可以直接调用该API完成自动化解析企业资质核验在供应商管理系统或招投标平台中自动读取营业执照中的统一社会信用代码、法人、准备资本等避免人工录入错误。合规审查金融或法律系统需要批量校验客户营业范围是否合规可通过接口实时提取经营范围字段。电商开店审核电商平台自动审核商家提交的营业执照图片快速填充公司名称、准备资金等信息。内部审批流企业OA系统在合同审批环节自动识别营业执照并归档字段。该API支持JPG/PNG图片最大10MB建议图片清晰无遮挡以保证识别准确率。接口能力边界在正式接入前需要明确该接口的限制维度说明接口地址https://v1.apizero.cn/api/business-license请求方法POST支持图片格式JPG、PNG单次图片大小≤ 10 MBQPS2次/秒识别字段数12个关键字段详见“返回字段解读”节返回格式JSON注意接口只返回识别到的文字字段不会对营业执照真实性做校验企业信息以国家企业信用信息公示系统为准。鉴权与请求头每次请求需在HTTP Header中携带两个必填参数Authorization:Bearer 你的API Key—— 在API平台获取密钥后替换实际值。Content-Type:application/json—— 请求体使用JSON格式。请妥善保管API Key不要在客户端代码中硬编码推荐使用环境变量或密钥管理服务。请求体参数详解请求体为JSON对象包含两个字段参数名必填类型说明input_type是string图片传入方式url网络图片链接或base64Base64编码字符串input_data是string图片URL或Base64字符串。若为Base64需注意不含前缀如data:image/png;base64,只传纯编码串大小不超过10MB。示例1使用URL{ input_type: url, input_data: https://example.com/business-license.jpg }示例2使用Base64将图片文件转换为Base64字符串后放入注意去掉换行符号{ input_type: base64, input_data: /9j/4AAQSkZJRg...省略 }如果图片较大建议使用URL方式减少请求体体积。使用curl快速测试最快捷的测试方法是直接使用curl命令。以下示例采用URL方式请将$APIZERO_API_KEY替换为你自己的API Key并将图片链接替换为实际图片地址curl -sS \ -X POST \ -H Authorization: Bearer $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {input_type: url, input_data: https://example.com/business-license.jpg} \ https://v1.apizero.cn/api/business-license若一切正常终端会返回类似下面的JSON{ code: 0, data: { unified_social_credit_code: 91310000XXXXXXXXXX, company_name: 某某科技有限公司, legal_representative: 张三, registered_capital: 100万人民币, business_scope: 软件开发信息技术咨询服务, company_type: 有限责任公司自然人独资, domicile: 上海市浦东新区某某路123号, established_date: 2015-06-01至无固定期限, established_time: 2015-06-01, approval_date: 2025-01-10, certificate_type: 营业执照, website: http://www.gsxt.gov.cn }, msg: 成功, request_id: req_abc123 }使用Python代码接入对于需要集成到后端服务的场景推荐使用Python的requests库。以下代码演示了从图片URL识别营业执照import requests import os # 从环境变量读取API Key API_KEY os.environ.get(APIZERO_API_KEY) if not API_KEY: raise ValueError(请设置环境变量 APIZERO_API_KEY) url https://v1.apizero.cn/api/business-license headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { input_type: url, input_data: https://example.com/business-license.jpg } try: response requests.post(url, headersheaders, jsonpayload, timeout15) response.raise_for_status() # 检查HTTP状态码 result response.json() if result.get(code) 0: data result[data] print(f统一社会信用代码: {data[unified_social_credit_code]}) print(f公司名称: {data[company_name]}) print(f法人: {data[legal_representative]}) print(f注册资本: {data[registered_capital]}) print(f经营范围: {data[business_scope]}) # 其他字段可按需提取 else: print(f业务错误: {result.get(msg)}) except requests.exceptions.RequestException as e: print(f网络或HTTP错误: {e})若使用Base64方式只需将payload中的input_type改为base64并替换input_data为编码后的字符串。返回字段解读API成功返回时data对象包含以下12个字段以实际返回为准字段名类型说明示例unified_social_credit_codestring统一社会信用代码18位91310000XXXXXXXXXXcompany_namestring公司全称某某科技有限公司legal_representativestring法定代表人姓名张三registered_capitalstring准备资本含单位100万人民币business_scopestring经营范围软件开发信息技术咨询服务company_typestring公司类型有限责任公司自然人独资domicilestring住所地址上海市浦东新区某某路123号established_datestring成立日期含期限2015-06-01至无固定期限established_timestring成立日期纯日期2015-06-01approval_datestring核准日期2025-01-10certificate_typestring证件类型固定为“营业执照”营业执照websitestring公示系统网址http://www.gsxt.gov.cn注意部分字段可能因图片质量或拍照角度导致漏识别建议在业务中增加非空校验。常见错误与排错错误现象可能原因解决方案HTTP 401Authorization Header 缺失或格式错误检查是否以“Bearer ”开头API Key是否有效HTTP 400请求体格式错误或必填字段缺失确保JSON有效input_type、input_data非空返回code ! 0图片无法识别模糊、过暗、遮挡、非营业执照更换清晰图片或检查Base64编码是否完整超时图片过大或网络延时压缩图片至10MB以下使用URL方式适当增加超时时间返回字段不全图片中该字段不可读如准备资金被遮挡提示用户重新拍摄或在业务侧做默认处理工程化注意事项批量处理由于QPS限制为2批量调用时需添加队列或限流控制比如使用time.sleep(0.6)保持请求间隔。重试策略如果网络超时或返回5xx错误可尝试重试1-2次建议指数退避。结果缓存对于同一个营业执照多次识别结果应保持一致建议在数据库中添加唯一索引统一社会信用代码避免重复存储。敏感信息保护营业执照图片可能包含隐私数据传输使用HTTPS存储时需加密。Base64处理读取文件后使用base64.b64encode(file.read()).decode(utf-8)注意去除换行。字段映射如果业务系统的字段命名不同建议建立一个映射表例如{company_name: name, legal_representative: legalPerson}。参考文档营业执照识别接口文档原始文档Markdown以上内容基于官方文档整理编写具体字段和参数以最新文档为准。