适用场景与接口定位在企业合作、投资尽调或风险控制场景中快速获取目标企业的多维度工商档案是常见的需求。传统做法依赖人工查询多个平台效率低且容易遗漏关键信息。本接口专为单一企业的深度调查设计输入企业名称支持简称或全称模糊匹配即可一次性返回工商基本信息、股东结构、主要成员、对外投资、历史变更记录以及六大类风险信息被执行、失信被执行、限制高消费、经营异常、严重违法、行政处罚。此外还附带企业规模标签、经营状态、成立年限、活力评分与自然语言摘要帮助开发者在代码层面快速获取尽调结论。与「企业工商信息查询」关键字列表检索不同本接口聚焦单一企业的完整档案支持按维度组合按需查询避免冗余数据。例如仅需基础信息与风险数据时可指定dimension为basic,risk减少响应体积。接口能力边界请求方式POST请求地址https://v1.apizero.cn/api/company-profileQPS5次/秒超出限制将返回429错误缓存策略数据来自权威工商数据库内部缓存6小时更新一次短期内重复查询同一企业不会产生新数据数据范围仅支持中国大陆境内准备的企业信息查询不支持个体工商户或境外企业请求参数与鉴权鉴权方式请求头部必须携带Authorization字段格式为Bearer 你的API Key。同时需要设置Content-Type: application/json。以下是一个完整的请求头部示例Authorization: Bearer YOUR_API_KEY_HERE Content-Type: application/json注意如果你使用的是旧版X-API-Key头部建议迁移到Authorization方式以文档最新要求为准。实际使用时请从你的账户后台获取有效API Key。请求体JSON请求体为JSON对象包含两个字段字段名类型是否必填说明companystring是企业名称2-80个字符含中文支持全称或简称模糊搜索。兼容别名namedimensionstring否查询维度逗号分隔。可选basic(基本信息)、shareholders(股东)、executives(高管)、investments(对外投资)、changes(变更记录)、risk(风险综合)。默认不传时返回全部维度示例请求体{ company: 阿里巴巴, dimension: basic,shareholders,risk }curl 请求示例以下是一个可直接复制的curl命令使用环境变量APIZERO_API_KEY存放你的密钥curl -sS \ -X POST \ -H Authorization: Bearer $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {company: 阿里巴巴, dimension: basic,shareholders,risk} \ https://v1.apizero.cn/api/company-profile如果不想依赖环境变量也可以直接替换字符串curl -sS -X POST \ -H Authorization: Bearer sk-your-api-key \ -H Content-Type: application/json \ -d {company:腾讯,dimension:basic,risk} \ https://v1.apizero.cn/api/company-profile成功响应会返回JSON格式的工商档案数据。代码接入Python示例对于后端开发者可以使用任何支持HTTP的语言集成。以下是用Pythonrequests库的调用示例import requests import json API_URL https://v1.apizero.cn/api/company-profile API_KEY your-api-key-here headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { company: 字节跳动, dimension: basic,executives,risk } try: resp requests.post(API_URL, headersheaders, jsonpayload, timeout10) resp.raise_for_status() result resp.json() if result.get(code) 0: data result[data] print(企业名称:, data.get(basic, {}).get(company_name)) print(经营状态:, data.get(basic, {}).get(business_status)) print(活力评分:, data.get(extension, {}).get(vitality_score)) print(风险总数:, data.get(stats, {}).get(risk_total)) else: print(接口异常:, result.get(msg)) except requests.exceptions.RequestException as e: print(请求失败:, e)注意实际生产环境中API Key 应通过环境变量或配置中心读取避免硬编码。返回值字段解读成功返回的JSON结构如下字段冗余只介绍关键部分{ code: 0, msg: 成功, request_id: uuid, data: { basic: { ... }, dimensions: [basic], extension: { ... }, stats: { ... } } }data.basic— 工商基本信息字段名示例值说明company_name阿里巴巴中国有限公司企业全称credit_code9133...统一社会信用代码部分脱敏legal_person示例法定代表人此处为脱敏示例business_status存续经营状态存续、注销、吊销等establish_date2007-03-26成立日期register_capital1.4 亿美元准备资本含币种可能为空data.extension— 扩展信息字段名示例值说明company_age_years19成立至今的年数register_capital_label巨型企业基于准备资本的规模标签summary自然语言摘要一段概括企业状态的中文描述vitality_score92企业活力评分0-100vitality_level极高活力等级极高/高/中/低data.stats— 统计概览字段名示例值说明risk_total0风险记录总数shareholder_count3股东个数提示当code不为0时应优先检查msg字段获取错误原因。完整的风险列表被执行、失信被执行等会在risk维度下返回具体字段以实际响应为准。常见错误排查HTTP状态码code字段可能原因处理建议4011001Authorization头缺失或API Key无效检查密钥是否正确是否已过期或未携带Bearer前缀4001002请求体JSON格式错误或company字段为空/超长校验JSON语法确保company为2-80个字符4291003单IP或单Key QPS超过5次/秒触发限流增加请求间隔或使用本地缓存减少重复调用4041004未找到对应企业数据库无记录或名称过于模糊尝试使用更精确的企业全称或检查是否为企业而非个体工商户5002000服务端内部错误返回request_id联系技术支持并提供该ID另外如果dimension传入了不支持的维度名称如abc接口不会报错而是忽略该维度并返回已支持的维度。建议调用前校验维度值是否在可选列表中。工程化注意事项1. 缓存策略由于接口数据有6小时缓存对于短时间内频繁查询同一企业的场景如仪表盘轮询建议在应用层也做一层本地缓存例如内存缓存或RedisTTL设为5分钟既能降低API调用次数又能规避QPS限制。2. 维度组合设计不是每次查询都需要全部维度。工具类调用中可以根据业务场景动态构建dimension参数初筛阶段仅查basic和extension获取企业存续状态和活力评分尽调阶段追加shareholders,executives,risk深度审计一次性全维度不传dimension默认全量这样既能减少响应体大小也能加快接口响应速度。3. 错误重试与退避针对网络抖动或限流429错误建议实现指数退避重试策略例如第一次重试等待1秒第二次2秒第三次4秒最多3次。注意避免对业务关键路径造成堆积。4. 数据脱敏与合规接口返回的credit_code可能已部分脱敏如示例中的9133...实际数据以真实响应为准。在日志中打印时应注意不要泄露完整的企业信用代码或法定代表人信息遵循数据最小化原则。5. 环境隔离建议在开发、测试和生产环境使用不同的API Key且生产环境的Key权限应设置为最小必要范围。参考文档官方文档页https://apizero.cn/aidocs/company-profile原始文档Markdownhttps://apizero.cn/aidocs/company-profile/raw.md以上文档包含最新的字段列表、更新日志和错误码枚举如遇接口变更请以此为准。
