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

接口定位与核心价值
核心功能：输入公司唯一 ID（company_id，从company_search接口或志趣网官网企业主页提取），返回企业全量详情；支持按需筛选返回字段（如仅获取工商信息 / 联系方式）、控制敏感信息展示（如企业法人身份证号、银行账户）；可联动志趣网 company_search/item_search/supply_get 接口，实现 “企业搜索→列表筛选→详情查看→交易对接” 的 B2B 业务闭环。
志趣网企业数据特性
B2B 交易属性突出：包含供应品类、年供应量、交易模式（批发 / 定制 / 租赁）、合作案例等 B 端决策核心字段，区别于通用工商信息接口；
经营能力多层级：返回主营产品、供应区域、服务范围、技术团队规模等数据，辅助评估企业履约能力；
诚信与风控信息完整：包含平台交易纠纷记录、好评率、投诉处理率、资质认证状态等信用维度数据，降低合作风险；
数据合规分级：基础工商信息开放所有权限，敏感信息（如法人手机号、银行账户）仅对企业高级权限开放。
典型应用场景
供应商背景调查：批量查询合作企业工商资质、经营年限、供应能力，生成供应商风险评估报告；
招商加盟筛选：按行业、供应能力、诚信等级筛选优质企业，精准匹配加盟需求；
企业风控系统：实时获取企业经营状态、资质有效性，预警异常经营风险；
B2B 平台商家入驻审核：自动核验入驻企业工商信息、资质文件，提高审核效率与合规性。
核心参数与返回字段
（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字段，评估合作可行性。
接口限制与注意事项
权限类型日调用上限调用频率适用场景
个人测试权限 50 次 / 天 1 次 / 秒功能调试、单个企业查询
企业基础权限 500 次 / 天 3 次 / 秒中小型 B2B 平台、供应商初步筛选
企业高级权限 5000 次 / 天 10 次 / 秒大型供应链平台、生产企业风控系统
数据缓存规则：工商基础信息缓存 24 小时，经营资质缓存 12 小时，供应能力与交易信用数据缓存 5 分钟；
地域与行业限制：特殊行业（如危化品、特种设备）企业信息仅对具备对应资质的企业开放；部分区域企业仅支持本地合作；
调用频率限制：超出频率上限会触发临时封禁 10 分钟，多次超限会导致权限降级；
合规要求：数据仅可用于企业内部风控或自有平台展示，严禁转售、篡改或用于恶意竞品分析，违反协议会被永久封禁账号。
二、对接前准备：权限与环境搭建
获取接口权限（官方唯一合规路径）
志趣网 item_get.company 接口权限需通过志趣网开放平台申请，步骤如下：
注册开发者账号：选择个人开发者或企业开发者，填写基本信息并完成实名认证；
提交资质审核：
企业用户：上传营业执照、B2B 业务备案证明（如有）、法人身份证；
个人用户：上传身份证，填写应用用途（如 “个人供应商背景调查工具”）；
创建应用：填写应用名称、服务器 IP 白名单、数据用途说明，提交审核（1-2 个工作日完成）；
获取密钥与令牌：审核通过后，在 “应用管理 - 密钥管理” 中获取app_key和app_secret；调用token_get接口生成token；
申请接口权限：在 “权限管理” 中选择zhiqu.item.get.company接口，提交申请，基础权限即时开通，高级权限需额外提交《数据合规使用承诺书》。
风险提示：严禁通过爬虫、抓包等非官方方式获取企业数据，违反协议会承担法律责任。
技术环境准备
（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']}")

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

优先用官方工具调试（排除签名与参数问题）
登录志趣网开放平台调试工具，选择 zhiqu.item.get.company 接口；
输入company_id、field_filter等参数，点击 “生成签名” 并发送请求；
若官方工具调用成功 → 问题出在代码的签名生成逻辑或参数拼接错误（如布尔参数未转小写、时间戳格式错误）；
若官方工具调用失败 → 问题出在权限配置或参数有效性（如company_id错误、IP 未加入白名单）。
高频问题排查表
问题现象常见原因解决方案
签名验证失败（401） 1. app_key/app_secret 错误或过期；
token 失效；
参数未按 ASCII 升序排序；
timestamp 与服务器时差 > 5 分钟 1. 核对开放平台密钥信息，过期则重新申请；
调用token_get接口刷新 token；
严格按参数名 ASCII 升序排序所有非空参数；
同步服务器时间，确保时间戳误差≤5 分钟
权限不足（403） 1. 未申请item_get.company接口权限；
服务器 IP 不在白名单；
调用频率超限；
访问敏感信息无高级权限 1. 在开放平台 “权限管理” 中申请接口；
添加服务器公网 IP 到应用白名单；
降低调用频率，控制并发数≤权限上限；
提交资质备案，申请高级权限
参数错误（400） 1. company_id 为空或格式非法；
field_filter 字段格式错误（如用分号分隔）；
company_id 对应的公司已注销 1. 确保传入有效的 company_id，格式为ZQ+日期+序号；
field_filter字段用英文逗号分隔；
在志趣网官网搜索company_id验证公司状态
无数据返回（200 但 data 为空） 1. 公司已注销 / 违规；
公司为新注册且无公开信息；
field_filter 参数传入错误字段 1. 更换有效 company_id 测试；
联系公司完善平台信息；
去掉field_filter参数，测试全字段返回结果
响应超时（504） 1. 网络波动或服务器负载高；
need_qualification=true 且资质数据量大；
高峰期调用（工作日 9:00-12:00/14:00-18:00） 1. 添加重试机制，设置超时时间为 15 秒；
非必要时关闭need_qualification参数；
避开高峰期调用，分批次获取数据
五、进阶优化：生产级稳定性提升
性能与配额优化
批量调用优化：多公司 ID 查询时，采用异步并发框架（如 Python 的aiohttp），并发数严格控制在权限允许的频率上限内（如企业基础权限 3 次 / 秒）；避免同步循环调用导致的效率低下。
智能缓存策略：用 Redis 缓存公司详情数据，缓存 key 设计为 zhiqucompany公司ID_字段过滤参数，缓存时间区分数据类型：
工商基础数据：缓存 24 小时；
经营资质与信用数据：缓存 12 小时；
供应能力与交易数据：缓存 5 分钟；
缓存失效触发条件：当接口返回公司经营状态或信用等级发生变化时，主动更新缓存。
字段按需加载：前端详情页采用懒加载策略：
首屏仅请求核心字段（公司名称 / 法人 / 信用等级）；
用户点击 “资质证书” 时，再请求qualification_urls字段；
用户点击 “供应能力” 时，再请求main_products/annual_supply字段；
减少单次请求的数据体积，提升响应速度。
数据质量优化
数据清洗与标准化：
按company_id去重，避免重复存储同一公司数据；
过滤异常值（如注册资本为 0、成立时间为空的公司）；
统一字段格式（如成立时间统一为 “YYYY - MM - DD” 格式，信用等级统一为大写）；
缺失值填充（如无法人信息填充为 “暂无”，无供应区域填充为 “全国”）。
数据一致性校验：定期对比接口返回数据与本地缓存数据，当公司经营状态、信用等级等关键字段发生变化时，触发业务告警（如公司经营状态异常提醒）。
合规与安全优化
密钥与 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 中的工商信息、资质证书数据，搭建企业合规审核平台，自动核验入驻企业合规性，提高审核效率

志趣网 item_get - 获取公司详情接口对接全攻略：从入门到精通

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

配置信息（替换为你的开放平台密钥与令牌）

调用示例

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

志趣网 item_get - 获取公司详情接口对接全攻略：从入门到精通

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

配置信息（替换为你的开放平台密钥与令牌）

调用示例

热门文章

最新文章

相关电子书