志趣网item_get公司详情接口（官方标准命名zhiqu.item.get.company）是面向B2B 批发、二手设备、闲置物资、招商加盟等场景的企业信息查询接口，通过公司唯一标识company_id可获取企业工商信息、经营资质、供应能力、联系方式、交易记录、诚信认证等全维度数据，适配供应商背景调查、招商企业筛选、供应链合规审核等核心需求。该接口采用HTTPS+AppKey/Secret+Token 三重签名认证，支持 JSON/XML 双格式返回，具备数据结构化强、工商与经营数据联动、交易信用维度完整的特点，是构建 B2B 企业风控系统、招商平台、供应商管理系统的核心依赖。本攻略提供从接口认知、权限准备、实操对接、调试排错到生产级优化的全链路标准化指导。

一、接口核心认知：功能与适配场景

1. 接口定位与核心价值

• 核心功能：输入公司唯一 ID（company_id，从company_search接口或志趣网官网企业主页提取），返回企业全量详情；支持按需筛选返回字段（如仅获取工商信息 / 联系方式）、控制敏感信息展示（如企业法人身份证号、银行账户）；可联动志趣网company_search/item_search/supply_get接口，实现 “企业搜索→列表筛选→详情查看→交易对接” 的 B2B 业务闭环。
• 志趣网企业数据特性
  • B2B 交易属性突出：包含供应品类、年供应量、交易模式（批发 / 定制 / 租赁）、合作案例等 B 端决策核心字段，区别于通用工商信息接口；
  • 经营能力多层级：返回主营产品、供应区域、服务范围、技术团队规模等数据，辅助评估企业履约能力；
  • 诚信与风控信息完整：包含平台交易纠纷记录、好评率、投诉处理率、资质认证状态等信用维度数据，降低合作风险；
  • 数据合规分级：基础工商信息开放所有权限，敏感信息（如法人手机号、银行账户）仅对企业高级权限开放。
• 典型应用场景
  1. 供应商背景调查：批量查询合作企业工商资质、经营年限、供应能力，生成供应商风险评估报告；
  2. 招商加盟筛选：按行业、供应能力、诚信等级筛选优质企业，精准匹配加盟需求；
  3. 企业风控系统：实时获取企业经营状态、资质有效性，预警异常经营风险；
  4. B2B 平台商家入驻审核：自动核验入驻企业工商信息、资质文件，提高审核效率与合规性。

2. 核心参数与返回字段

（1）请求参数（GET/POST 提交，需签名认证）

注意事项

1. token需通过志趣网token_get接口生成，传入app_key和app_secret即可获取，过期需重新调用；
2. timestamp与服务器时间误差超过 5 分钟会触发签名验证失败，建议对接时调用平台时间接口同步；
3. field_filter参数可大幅减少响应数据体积，提升接口调用效率，适合移动端等带宽敏感场景。

（2）返回核心字段（按业务分类）

提示：定制化企业的annual_supply字段可能为0，需重点关注main_products、supply_region和transaction_model字段，评估合作可行性。

3. 接口限制与注意事项

• 数据缓存规则：工商基础信息缓存 24 小时，经营资质缓存 12 小时，供应能力与交易信用数据缓存 5 分钟；
• 地域与行业限制：特殊行业（如危化品、特种设备）企业信息仅对具备对应资质的企业开放；部分区域企业仅支持本地合作；
• 调用频率限制：超出频率上限会触发临时封禁 10 分钟，多次超限会导致权限降级；
• 合规要求：数据仅可用于企业内部风控或自有平台展示，严禁转售、篡改或用于恶意竞品分析，违反协议会被永久封禁账号。

二、对接前准备：权限与环境搭建

1. 获取接口权限（官方唯一合规路径）

志趣网item_get.company接口权限需通过志趣网开放平台申请，步骤如下：

1. 注册开发者账号：选择个人开发者或企业开发者，填写基本信息并完成实名认证；
2. 提交资质审核：
   • 企业用户：上传营业执照、B2B 业务备案证明（如有）、法人身份证；
   • 个人用户：上传身份证，填写应用用途（如 “个人供应商背景调查工具”）；
3. 创建应用：填写应用名称、服务器 IP 白名单、数据用途说明，提交审核（1-2 个工作日完成）；
4. 获取密钥与令牌：审核通过后，在 “应用管理 - 密钥管理” 中获取app_key和app_secret；调用token_get接口生成token；
5. 申请接口权限：在 “权限管理” 中选择zhiqu.item.get.company接口，提交申请，基础权限即时开通，高级权限需额外提交《数据合规使用承诺书》。

风险提示：严禁通过爬虫、抓包等非官方方式获取企业数据，违反协议会承担法律责任。

2. 技术环境准备

（1）支持语言与协议

• 协议：HTTPS（强制），HTTP 请求会被直接拦截并返回 403 错误；
• 开发语言：Python、Java、PHP、Go 等主流语言均可，推荐 Python（代码简洁，适配签名生成与数据解析）。

（2）必备工具与依赖

三、实操步骤：接口对接全流程（Python 示例）

步骤 1：理解签名认证规则（核心，必掌握）

志趣网item_get.company接口采用app_key+app_secret+token+timestamp 签名认证机制，签名生成步骤如下：

1. 收集所有非空请求参数（含公共参数和业务参数）；
2. 按参数名ASCII 升序排序（如api_name排在app_key之前）；
3. 拼接参数为key1value1key2value2...的字符串格式（无分隔符，参数值需与传入一致）；
4. 将app_secret拼接在参数串末尾，生成签名原串；
5. 对原串进行MD5 加密，转为小写字符串，即为签名sign；
6. 将sign添加到请求参数中，发送 HTTPS GET 请求。

步骤 2：完整代码实现（含签名生成 + 调用 + 数据标准化）

（1）依赖安装

bash

pip install requests hashlib jsonpath-ng pandas

（2）Python 代码实现

import requests import hashlib import time import logging import pandas as pd from typing import Optional, Dict # 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex # 日志配置：记录调用日志，便于问题排查与审计 logging.basicConfig( level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s", handlers=[logging.FileHandler("zhiqu_company_get.log"), logging.StreamHandler()] ) # 配置信息（替换为你的开放平台密钥与令牌） CONFIG = { "app_key": "你的app_key", "app_secret": "你的app_secret", "token": "你的token", "api_url": "https://openapi.zhiqu.com/zhiqu/item_get/company", "format": "json" } def generate_sign(params: Dict[str, str], app_secret: str) -> str: """生成志趣网接口签名（MD5加密，小写）""" # 1. 按参数名ASCII升序排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接参数为 key1value1key2value2 格式 param_str = "".join([f"{k}{v}" for k, v in sorted_params]) # 3. 拼接app_secret并MD5加密 sign_str = param_str + app_secret sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().lower() return sign def standardize_company_detail(raw_data: Dict) -> Dict: """标准化公司详情数据，统一输出格式""" # 处理工商信息 legal_person = raw_data.get("legal_person", "暂无") establish_time = raw_data.get("establish_time", "暂无") registered_capital = raw_data.get("registered_capital", "暂无") business_scope = raw_data.get("business_scope", "暂无") operating_status = raw_data.get("operating_status", "暂无") # 处理资质与信用 qual_count = len(raw_data.get("qualification_urls", [])) credit_level = raw_data.get("credit_level", "暂无") dispute_rate = raw_data.get("dispute_rate", 0.0) praise_rate = raw_data.get("praise_rate", 0.0) # 处理供应能力 main_products = raw_data.get("main_products", []) main_products_str = "; ".join(main_products) if main_products else "暂无" supply_region = raw_data.get("supply_region", "暂无") annual_supply = raw_data.get("annual_supply", 0) transaction_model = raw_data.get("transaction_model", "暂无") # 处理联系方式 contact_person = raw_data.get("contact_person", "暂无") contact_phone = raw_data.get("contact_phone", "权限不足") contact_email = raw_data.get("contact_email", "暂无") address = raw_data.get("address", "暂无") return { "公司ID": raw_data.get("company_id", ""), "公司名称": raw_data.get("company_name", ""), "统一社会信用代码": raw_data.get("unified_social_credit_code", ""), "法人": legal_person, "成立时间": establish_time, "注册资本": registered_capital, "经营范围": business_scope, "经营状态": operating_status, "主营产品": main_products_str, "供应区域": supply_region, "年供应量": annual_supply, "交易模式": transaction_model, "诚信等级": credit_level, "资质证书数量": qual_count, "交易纠纷率": dispute_rate, "买家好评率": praise_rate, "联系人": contact_person, "联系电话": contact_phone, "联系邮箱": contact_email, "公司地址": address, "数据请求时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) } def zhiqu_item_get_company( company_id: str, field_filter: Optional[str] = None, need_business: bool = True, need_qualification: bool = False, need_supply: bool = True, need_trade: bool = True ) -> Dict: """调用志趣网item_get接口获取公司详情""" # 1. 校验必填参数 if not company_id: return {"success": False, "error_msg": "company_id不能为空", "data": {}} if not CONFIG["token"]: return {"success": False, "error_msg": "token未配置，请先调用token_get接口", "data": {}} # 2. 构建公共参数 params = { "app_key": CONFIG["app_key"], "token": CONFIG["token"], "api_name": "zhiqu.item.get.company", "format": CONFIG["format"], "timestamp": str(int(time.time())), "company_id": company_id, "need_business": str(need_business).lower(), "need_qualification": str(need_qualification).lower(), "need_supply": str(need_supply).lower(), "need_trade": str(need_trade).lower() } # 3. 添加工业务参数 if field_filter: params["field_filter"] = field_filter # 4. 生成签名 sign = generate_sign(params, CONFIG["app_secret"]) params["sign"] = sign try: # 5. 发送HTTPS请求 response = requests.get( url=CONFIG["api_url"], params=params, timeout=15, verify=True # 生产环境必须开启证书验证 ) response.raise_for_status() # 抛出HTTP状态码异常 result = response.json() # 6. 解析响应结果 if result.get("code") != 200: error_msg = f"[{result.get('code', '未知错误')}] {result.get('msg', '无错误信息')}" logging.error(f"获取公司详情失败（公司ID：{company_id}）：{error_msg}") return {"success": False, "error_msg": error_msg, "data": {}} raw_detail = result.get("data", {}).get("company_detail", {}) if not raw_detail: logging.warning(f"无公司详情数据返回（公司ID：{company_id}）") return {"success": False, "error_msg": "无匹配公司详情数据", "data": {}} # 7. 标准化数据 standard_data = standardize_company_detail(raw_detail) return { "success": True, "data": standard_data, "error_msg": "" } except requests.exceptions.RequestException as e: logging.error(f"网络请求异常（公司ID：{company_id}）：{str(e)}") return {"success": False, "error_msg": f"网络异常：{str(e)}", "data": {}} except Exception as e: logging.error(f"数据解析异常（公司ID：{company_id}）：{str(e)}") return {"success": False, "error_msg": f"解析异常：{str(e)}", "data": {}} # 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex # 调用示例 if __name__ == "__main__": # 示例：查询单个公司详情 target_company_id = "ZQ20260201001" result = zhiqu_item_get_company( company_id=target_company_id, field_filter="company_name,legal_person,credit_level,main_products,contact_person", need_business=True, need_qualification=False, need_supply=True, need_trade=True ) if result["success"]: print("=== 志趣网公司详情 ===") for k, v in result["data"].items(): print(f"{k}: {v}") # 保存为Excel df = pd.DataFrame([result["data"]]) df.to_excel(f"志趣网公司详情_{target_company_id}.xlsx", index=False) else: print(f"获取失败：{result['error_msg']}")

四、调试与问题排查：快速解决对接异常

1. 优先用官方工具调试（排除签名与参数问题）

1. 登录志趣网开放平台调试工具，选择zhiqu.item.get.company接口；
2. 输入company_id、field_filter等参数，点击 “生成签名” 并发送请求；
3. 若官方工具调用成功 → 问题出在代码的签名生成逻辑或参数拼接错误（如布尔参数未转小写、时间戳格式错误）；
4. 若官方工具调用失败 → 问题出在权限配置或参数有效性（如company_id错误、IP 未加入白名单）。

2. 高频问题排查表

五、进阶优化：生产级稳定性提升

1. 性能与配额优化

• 批量调用优化：多公司 ID 查询时，采用异步并发框架（如 Python 的aiohttp），并发数严格控制在权限允许的频率上限内（如企业基础权限 3 次 / 秒）；避免同步循环调用导致的效率低下。
• 智能缓存策略：用 Redis 缓存公司详情数据，缓存 key 设计为zhiqu_company_公司ID_字段过滤参数，缓存时间区分数据类型：
  • 工商基础数据：缓存 24 小时；
  • 经营资质与信用数据：缓存 12 小时；
  • 供应能力与交易数据：缓存 5 分钟；缓存失效触发条件：当接口返回公司经营状态或信用等级发生变化时，主动更新缓存。
• 字段按需加载：前端详情页采用懒加载策略：
  1. 首屏仅请求核心字段（公司名称 / 法人 / 信用等级）；
  2. 用户点击 “资质证书” 时，再请求qualification_urls字段；
  3. 用户点击 “供应能力” 时，再请求main_products/annual_supply字段；减少单次请求的数据体积，提升响应速度。

2. 数据质量优化

• 数据清洗与标准化：
  1. 按company_id去重，避免重复存储同一公司数据；
  2. 过滤异常值（如注册资本为 0、成立时间为空的公司）；
  3. 统一字段格式（如成立时间统一为 “YYYY - MM - DD” 格式，信用等级统一为大写）；
  4. 缺失值填充（如无法人信息填充为 “暂无”，无供应区域填充为 “全国”）。
• 数据一致性校验：定期对比接口返回数据与本地缓存数据，当公司经营状态、信用等级等关键字段发生变化时，触发业务告警（如公司经营状态异常提醒）。

3. 合规与安全优化

• 密钥与 Token 安全管理：
  1. 生产环境禁止硬编码 app_key/app_secret/token，推荐存入配置中心（如 Nacos、Apollo），应用启动时动态拉取；
  2. Token 有效期为 24 小时，需设置定时任务自动刷新，避免因 Token 过期导致接口调用失败；
  3. 定期轮换 app_secret（建议每 3 个月一次），降低密钥泄露风险。
• 重试与熔断机制：
  1. 对临时性错误（403 频率超限、504 超时），采用指数退避重试策略（首次间隔 1 秒，之后翻倍，最多重试 3 次）；
  2. 对永久性错误（401 签名错误、400 参数错误），直接抛出异常，不重试；
  3. 引入熔断机制（如pybreaker库），当接口连续失败次数≥5 次时，暂停调用 5 分钟，避免雪崩效应。
• 日志审计：记录每次调用的company_id、field_filter、响应状态、耗时、返回数据量等信息，日志保留至少 30 天，满足合规审计要求。

六、扩展场景：接口联动与功能升级

1. 全链路 B2B 企业风控闭环：联动cate_tree获取行业品类 →company_search按行业 / 信用等级筛选企业列表 →item_get.company批量获取公司详情 →supply_get查询供应能力 → 实现 “行业筛选 - 企业检索 - 详情查看 - 供应评估” 的风控全流程自动化；
2. 供应商动态监控系统：定时调用item_get.company接口，对比企业信用等级、交易纠纷率等数据，当纠纷率上升超过设定阈值（如 5%）时，通过邮件 / 短信推送风险预警；
3. 招商加盟匹配平台：基于item_get.company返回的供应区域、主营产品、交易模式等数据，结合加盟商需求，智能匹配优质招商企业；
4. 企业合规审核系统：整合item_get.company中的工商信息、资质证书数据，搭建企业合规审核平台，自动核验入驻企业合规性，提高审核效率