志趣网 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 端决策核心字段，区别于通用工商信息接口；
   经营能力多层级：返回主营产品、供应区域、服务范围、技术团队规模等数据，辅助评估企业履约能力；
   诚信与风控信息完整：包含平台交易纠纷记录、好评率、投诉处理率、资质认证状态等信用维度数据，降低合作风险；
   数据合规分级：基础工商信息开放所有权限，敏感信息（如法人手机号、银行账户）仅对企业高级权限开放。
   典型应用场景
   供应商背景调查：批量查询合作企业工商资质、经营年限、供应能力，生成供应商风险评估报告；
   招商加盟筛选：按行业、供应能力、诚信等级筛选优质企业，精准匹配加盟需求；
   企业风控系统：实时获取企业经营状态、资质有效性，预警异常经营风险；
   B2B 平台商家入驻审核：自动核验入驻企业工商信息、资质文件，提高审核效率与合规性。
2. 核心参数与返回字段
   （1）请求参数（GET/POST 提交，需签名认证）
   参数类型 参数名称 类型 是否必填 说明 应用示例
   公共参数 app_key string 是 应用唯一标识（开放平台获取） zhiqu_appkey_2026_abc123
   app_secret string 是 应用秘钥（开放平台获取） zhiqu_secret_2026_def456
   token string 是 访问令牌（token_get接口获取，有效期 24h） zhiqu_token_2026_xyz789
   api_name string 是 接口名称，固定为item_get.company zhiqu.item.get.company
   format string 否 响应格式，默认 JSON json/xml
   timestamp string 是 秒级时间戳，与服务器时差≤5 分钟 1735689600
   业务参数 company_id string 是 公司唯一 ID ZQ20260201001
   field_filter string 否 字段过滤（指定返回字段，逗号分隔） company_name,credit_level,business_scope,contact_info
   need_business bool 否 是否返回工商信息，默认 true true/false
   need_qualification bool 否 是否返回资质证书，默认 false true/false
   need_supply bool 否 是否返回供应能力，默认 true true/false
   need_trade bool 否 是否返回交易记录，默认 true true/false
   注意事项
   token 需通过志趣网 token_get 接口生成，传入app_key和app_secret即可获取，过期需重新调用；
   timestamp 与服务器时间误差超过 5 分钟会触发签名验证失败，建议对接时调用平台时间接口同步；
   field_filter 参数可大幅减少响应数据体积，提升接口调用效率，适合移动端等带宽敏感场景。
   （2）返回核心字段（按业务分类）
   字段分类 核心字段 说明
   工商基础信息 company_id、company_name、unified_social_credit_code、legal_person、establish_time、business_scope、registered_capital、operating_status unified_social_credit_code：统一社会信用代码；operating_status：经营状态（存续 / 注销 / 吊销）
   经营资质信息 qualification_urls、business_license_url、industry_license_urls、credit_level credit_level：平台诚信等级（AAA/AAB/AAC）；qualification_urls：资质证书 URL 列表
   供应能力信息 main_products、supply_region、annual_supply、transaction_model、cooperation_cases transaction_model：交易模式（批发 / 定制 / 租赁 / 加盟）；annual_supply：年供应量
   联系方式信息 contact_person、contact_phone、contact_email、address、website contact_phone仅企业高级权限返回，测试权限显示*
   交易信用信息 transaction_count、dispute_rate、praise_rate、complaint_resolve_rate dispute_rate：交易纠纷率；praise_rate：买家好评率
   企业状态信息 update_time、status、view_count status：正常 / 异常 / 暂停服务；view_count：平台浏览量
   提示：定制化企业的annual_supply字段可能为0，需重点关注main_products、supply_region和transaction_model字段，评估合作可行性。
3. 接口限制与注意事项
   权限类型 日调用上限 调用频率 适用场景
   个人测试权限 50 次 / 天 1 次 / 秒 功能调试、单个企业查询
   企业基础权限 500 次 / 天 3 次 / 秒 中小型 B2B 平台、供应商初步筛选
   企业高级权限 5000 次 / 天 10 次 / 秒 大型供应链平台、生产企业风控系统
   数据缓存规则：工商基础信息缓存 24 小时，经营资质缓存 12 小时，供应能力与交易信用数据缓存 5 分钟；
   地域与行业限制：特殊行业（如危化品、特种设备）企业信息仅对具备对应资质的企业开放；部分区域企业仅支持本地合作；
   调用频率限制：超出频率上限会触发临时封禁 10 分钟，多次超限会导致权限降级；
   合规要求：数据仅可用于企业内部风控或自有平台展示，严禁转售、篡改或用于恶意竞品分析，违反协议会被永久封禁账号。
   二、对接前准备：权限与环境搭建
4. 获取接口权限（官方唯一合规路径）
   志趣网 item_get.company 接口权限需通过志趣网开放平台申请，步骤如下：
   注册开发者账号：选择个人开发者或企业开发者，填写基本信息并完成实名认证；
   提交资质审核：
   企业用户：上传营业执照、B2B 业务备案证明（如有）、法人身份证；
   个人用户：上传身份证，填写应用用途（如 “个人供应商背景调查工具”）；
   创建应用：填写应用名称、服务器 IP 白名单、数据用途说明，提交审核（1-2 个工作日完成）；
   获取密钥与令牌：审核通过后，在 “应用管理 - 密钥管理” 中获取app_key和app_secret；调用token_get接口生成token；
   申请接口权限：在 “权限管理” 中选择zhiqu.item.get.company接口，提交申请，基础权限即时开通，高级权限需额外提交《数据合规使用承诺书》。
   风险提示：严禁通过爬虫、抓包等非官方方式获取企业数据，违反协议会承担法律责任。
5. 技术环境准备
   （1）支持语言与协议
   协议：HTTPS（强制），HTTP 请求会被直接拦截并返回 403 错误；
   开发语言：Python、Java、PHP、Go 等主流语言均可，推荐 Python（代码简洁，适配签名生成与数据解析）。
   （2）必备工具与依赖
   工具类型 推荐工具 用途
   调试工具 志趣网开放平台调试工具 在线输入参数、生成签名、测试接口响应
   Postman 模拟 GET/POST 请求，保存测试用例
   开发依赖（Python） requests 发送 HTTPS 请求
   hashlib 生成 MD5 签名
   jsonpath-ng 快速解析嵌套 JSON 企业数据
   pandas 整理企业数据并导出 Excel
   辅助工具 Redis 缓存企业详情数据，减少重复调用
   logging 记录接口调用日志，便于问题排查
   三、实操步骤：接口对接全流程（Python 示例）
   步骤 1：理解签名认证规则（核心，必掌握）
   志趣网 item_get.company 接口采用 app_key+app_secret+token+timestamp 签名认证 机制，签名生成步骤如下：
   收集所有非空请求参数（含公共参数和业务参数）；
   按参数名ASCII 升序排序（如api_name排在app_key之前）；
   拼接参数为 key1value1key2value2... 的字符串格式（无分隔符，参数值需与传入一致）；
   将 app_secret 拼接在参数串末尾，生成签名原串；
   对原串进行 MD5 加密，转为小写字符串，即为签名 sign；
   将 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

日志配置：记录调用日志，便于问题排查与审计

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

调用示例

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. 优先用官方工具调试（排除签名与参数问题）
   登录志趣网开放平台调试工具，选择 zhiqu.item.get.company 接口；
   输入company_id、field_filter等参数，点击 “生成签名” 并发送请求；
   若官方工具调用成功 → 问题出在代码的签名生成逻辑或参数拼接错误（如布尔参数未转小写、时间戳格式错误）；
   若官方工具调用失败 → 问题出在权限配置或参数有效性（如company_id错误、IP 未加入白名单）。
2. 高频问题排查表
   问题现象 常见原因 解决方案
   签名验证失败（401） 1. app_key/app_secret 错误或过期；
3. token 失效；
4. 参数未按 ASCII 升序排序；
5. timestamp 与服务器时差 > 5 分钟 1. 核对开放平台密钥信息，过期则重新申请；
6. 调用token_get接口刷新 token；
7. 严格按参数名 ASCII 升序排序所有非空参数；
8. 同步服务器时间，确保时间戳误差≤5 分钟
   权限不足（403） 1. 未申请item_get.company接口权限；
9. 服务器 IP 不在白名单；
10. 调用频率超限；
11. 访问敏感信息无高级权限 1. 在开放平台 “权限管理” 中申请接口；
12. 添加服务器公网 IP 到应用白名单；
13. 降低调用频率，控制并发数≤权限上限；
14. 提交资质备案，申请高级权限
    参数错误（400） 1. company_id 为空或格式非法；
15. field_filter 字段格式错误（如用分号分隔）；
16. company_id 对应的公司已注销 1. 确保传入有效的 company_id，格式为ZQ+日期+序号；
17. field_filter字段用英文逗号分隔；
18. 在志趣网官网搜索company_id验证公司状态
    无数据返回（200 但 data 为空） 1. 公司已注销 / 违规；
19. 公司为新注册且无公开信息；
20. field_filter 参数传入错误字段 1. 更换有效 company_id 测试；
21. 联系公司完善平台信息；
22. 去掉field_filter参数，测试全字段返回结果
    响应超时（504） 1. 网络波动或服务器负载高；
23. need_qualification=true 且资质数据量大；
24. 高峰期调用（工作日 9:00-12:00/14:00-18:00） 1. 添加重试机制，设置超时时间为 15 秒；
25. 非必要时关闭need_qualification参数；
26. 避开高峰期调用，分批次获取数据
    五、进阶优化：生产级稳定性提升
27. 性能与配额优化
    批量调用优化：多公司 ID 查询时，采用 异步并发框架（如 Python 的aiohttp），并发数严格控制在权限允许的频率上限内（如企业基础权限 3 次 / 秒）；避免同步循环调用导致的效率低下。
    智能缓存策略：用 Redis 缓存公司详情数据，缓存 key 设计为 zhiqucompany公司ID_字段过滤参数，缓存时间区分数据类型：
    工商基础数据：缓存 24 小时；
    经营资质与信用数据：缓存 12 小时；
    供应能力与交易数据：缓存 5 分钟；
    缓存失效触发条件：当接口返回公司经营状态或信用等级发生变化时，主动更新缓存。
    字段按需加载：前端详情页采用懒加载策略：
    首屏仅请求核心字段（公司名称 / 法人 / 信用等级）；
    用户点击 “资质证书” 时，再请求qualification_urls字段；
    用户点击 “供应能力” 时，再请求main_products/annual_supply字段；
    减少单次请求的数据体积，提升响应速度。
28. 数据质量优化
    数据清洗与标准化：
    按company_id去重，避免重复存储同一公司数据；
    过滤异常值（如注册资本为 0、成立时间为空的公司）；
    统一字段格式（如成立时间统一为 “YYYY - MM - DD” 格式，信用等级统一为大写）；
    缺失值填充（如无法人信息填充为 “暂无”，无供应区域填充为 “全国”）。
    数据一致性校验：定期对比接口返回数据与本地缓存数据，当公司经营状态、信用等级等关键字段发生变化时，触发业务告警（如公司经营状态异常提醒）。
29. 合规与安全优化
    密钥与 Token 安全管理：
    生产环境禁止硬编码 app_key/app_secret/token，推荐存入配置中心（如 Nacos、Apollo），应用启动时动态拉取；
    Token 有效期为 24 小时，需设置定时任务自动刷新，避免因 Token 过期导致接口调用失败；
    定期轮换 app_secret（建议每 3 个月一次），降低密钥泄露风险。
    重试与熔断机制：
    对临时性错误（403 频率超限、504 超时），采用指数退避重试策略（首次间隔 1 秒，之后翻倍，最多重试 3 次）；
    对永久性错误（401 签名错误、400 参数错误），直接抛出异常，不重试；
    引入熔断机制（如pybreaker库），当接口连续失败次数≥5 次时，暂停调用 5 分钟，避免雪崩效应。
    日志审计：记录每次调用的company_id、field_filter、响应状态、耗时、返回数据量等信息，日志保留至少 30 天，满足合规审计要求。
    六、扩展场景：接口联动与功能升级
    全链路 B2B 企业风控闭环：联动 cate_tree 获取行业品类 → company_search 按行业 / 信用等级筛选企业列表 → item_get.company 批量获取公司详情 → supply_get 查询供应能力 → 实现 “行业筛选 - 企业检索 - 详情查看 - 供应评估” 的风控全流程自动化；
    供应商动态监控系统：定时调用 item_get.company 接口，对比企业信用等级、交易纠纷率等数据，当纠纷率上升超过设定阈值（如 5%）时，通过邮件 / 短信推送风险预警；
    招商加盟匹配平台：基于 item_get.company 返回的供应区域、主营产品、交易模式等数据，结合加盟商需求，智能匹配优质招商企业；
    企业合规审核系统：整合 item_get.company 中的工商信息、资质证书数据，搭建企业合规审核平台，自动核验入驻企业合规性，提高审核效率