企业官网建设流程全解析

自己有了域名 怎么做网站,服务器 空间 虚拟主机 网站需要,外链服务,工业设计公司排行志趣网 item_get 公司详情接口#xff08;官方标准命名 zhiqu.item.get.company#xff09;是面向B2B 批发、二手设备、闲置物资、招商加盟等场景的企业信息查询接口#xff0c;通过公司唯一标识 company_id 可获取企业工商信息、经营资质、供应能力、联系方式、交易记录、诚…志趣网item_get公司详情接口官方标准命名zhiqu.item.get.company是面向B2B 批发、二手设备、闲置物资、招商加盟等场景的企业信息查询接口通过公司唯一标识company_id可获取企业工商信息、经营资质、供应能力、联系方式、交易记录、诚信认证等全维度数据适配供应商背景调查、招商企业筛选、供应链合规审核等核心需求。该接口采用HTTPSAppKey/SecretToken 三重签名认证支持 JSON/XML 双格式返回具备数据结构化强、工商与经营数据联动、交易信用维度完整的特点是构建 B2B 企业风控系统、招商平台、供应商管理系统的核心依赖。本攻略提供从接口认知、权限准备、实操对接、调试排错到生产级优化的全链路标准化指导。一、接口核心认知功能与适配场景1. 接口定位与核心价值核心功能输入公司唯一 IDcompany_id从company_search接口或志趣网官网企业主页提取返回企业全量详情支持按需筛选返回字段如仅获取工商信息 / 联系方式、控制敏感信息展示如企业法人身份证号、银行账户可联动志趣网company_search/item_search/supply_get接口实现 “企业搜索→列表筛选→详情查看→交易对接” 的 B2B 业务闭环。志趣网企业数据特性B2B 交易属性突出包含供应品类、年供应量、交易模式批发 / 定制 / 租赁、合作案例等 B 端决策核心字段区别于通用工商信息接口经营能力多层级返回主营产品、供应区域、服务范围、技术团队规模等数据辅助评估企业履约能力诚信与风控信息完整包含平台交易纠纷记录、好评率、投诉处理率、资质认证状态等信用维度数据降低合作风险数据合规分级基础工商信息开放所有权限敏感信息如法人手机号、银行账户仅对企业高级权限开放。典型应用场景供应商背景调查批量查询合作企业工商资质、经营年限、供应能力生成供应商风险评估报告招商加盟筛选按行业、供应能力、诚信等级筛选优质企业精准匹配加盟需求企业风控系统实时获取企业经营状态、资质有效性预警异常经营风险B2B 平台商家入驻审核自动核验入驻企业工商信息、资质文件提高审核效率与合规性。2. 核心参数与返回字段1请求参数GET/POST 提交需签名认证参数类型参数名称类型是否必填说明应用示例公共参数app_keystring是应用唯一标识开放平台获取zhiqu_appkey_2026_abc123app_secretstring是应用秘钥开放平台获取zhiqu_secret_2026_def456tokenstring是访问令牌token_get接口获取有效期 24hzhiqu_token_2026_xyz789api_namestring是接口名称固定为item_get.companyzhiqu.item.get.companyformatstring否响应格式默认 JSONjson/xmltimestampstring是秒级时间戳与服务器时差≤5 分钟1735689600业务参数company_idstring是公司唯一 IDZQ20260201001field_filterstring否字段过滤指定返回字段逗号分隔company_name,credit_level,business_scope,contact_infoneed_businessbool否是否返回工商信息默认 truetrue/falseneed_qualificationbool否是否返回资质证书默认 falsetrue/falseneed_supplybool否是否返回供应能力默认 truetrue/falseneed_tradebool否是否返回交易记录默认 truetrue/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_statusunified_social_credit_code统一社会信用代码operating_status经营状态存续 / 注销 / 吊销经营资质信息qualification_urls、business_license_url、industry_license_urls、credit_levelcredit_level平台诚信等级AAA/AAB/AACqualification_urls资质证书 URL 列表供应能力信息main_products、supply_region、annual_supply、transaction_model、cooperation_casestransaction_model交易模式批发 / 定制 / 租赁 / 加盟annual_supply年供应量联系方式信息contact_person、contact_phone、contact_email、address、websitecontact_phone仅企业高级权限返回测试权限显示***交易信用信息transaction_count、dispute_rate、praise_rate、complaint_resolve_ratedispute_rate交易纠纷率praise_rate买家好评率企业状态信息update_time、status、view_countstatus正常 / 异常 / 暂停服务view_count平台浏览量提示定制化企业的annual_supply字段可能为0需重点关注main_products、supply_region和transaction_model字段评估合作可行性。3. 接口限制与注意事项权限类型日调用上限调用频率适用场景个人测试权限50 次 / 天1 次 / 秒功能调试、单个企业查询企业基础权限500 次 / 天3 次 / 秒中小型 B2B 平台、供应商初步筛选企业高级权限5000 次 / 天10 次 / 秒大型供应链平台、生产企业风控系统数据缓存规则工商基础信息缓存 24 小时经营资质缓存 12 小时供应能力与交易信用数据缓存 5 分钟地域与行业限制特殊行业如危化品、特种设备企业信息仅对具备对应资质的企业开放部分区域企业仅支持本地合作调用频率限制超出频率上限会触发临时封禁 10 分钟多次超限会导致权限降级合规要求数据仅可用于企业内部风控或自有平台展示严禁转售、篡改或用于恶意竞品分析违反协议会被永久封禁账号。二、对接前准备权限与环境搭建1. 获取接口权限官方唯一合规路径志趣网item_get.company接口权限需通过志趣网开放平台申请步骤如下注册开发者账号选择个人开发者或企业开发者填写基本信息并完成实名认证提交资质审核企业用户上传营业执照、B2B 业务备案证明如有、法人身份证个人用户上传身份证填写应用用途如 “个人供应商背景调查工具”创建应用填写应用名称、服务器 IP 白名单、数据用途说明提交审核1-2 个工作日完成获取密钥与令牌审核通过后在 “应用管理 - 密钥管理” 中获取app_key和app_secret调用token_get接口生成token申请接口权限在 “权限管理” 中选择zhiqu.item.get.company接口提交申请基础权限即时开通高级权限需额外提交《数据合规使用承诺书》。风险提示严禁通过爬虫、抓包等非官方方式获取企业数据违反协议会承担法律责任。2. 技术环境准备1支持语言与协议协议HTTPS强制HTTP 请求会被直接拦截并返回 403 错误开发语言Python、Java、PHP、Go 等主流语言均可推荐 Python代码简洁适配签名生成与数据解析。2必备工具与依赖工具类型推荐工具用途调试工具志趣网开放平台调试工具在线输入参数、生成签名、测试接口响应Postman模拟 GET/POST 请求保存测试用例开发依赖Pythonrequests发送 HTTPS 请求hashlib生成 MD5 签名jsonpath-ng快速解析嵌套 JSON 企业数据pandas整理企业数据并导出 Excel辅助工具Redis缓存企业详情数据减少重复调用logging记录接口调用日志便于问题排查三、实操步骤接口对接全流程Python 示例步骤 1理解签名认证规则核心必掌握志趣网item_get.company接口采用app_keyapp_secrettokentimestamp 签名认证机制签名生成步骤如下收集所有非空请求参数含公共参数和业务参数按参数名ASCII 升序排序如api_name排在app_key之前拼接参数为key1value1key2value2...的字符串格式无分隔符参数值需与传入一致将app_secret拼接在参数串末尾生成签名原串对原串进行MD5 加密转为小写字符串即为签名sign将sign添加到请求参数中发送 HTTPS GET 请求。步骤 2完整代码实现含签名生成 调用 数据标准化1依赖安装bashpip install requests hashlib jsonpath-ng pandas2Python 代码实现import requests import hashlib import time import logging import pandas as pd from typing import Optional, Dict # 封装好API供应商demo urlhttps://console.open.onebound.cn/console/?iLex # 日志配置记录调用日志便于问题排查与审计 logging.basicConfig( levellogging.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(), keylambda 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( urlCONFIG[api_url], paramsparams, timeout15, verifyTrue # 生产环境必须开启证书验证 ) 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 urlhttps://console.open.onebound.cn/console/?iLex # 调用示例 if __name__ __main__: # 示例查询单个公司详情 target_company_id ZQ20260201001 result zhiqu_item_get_company( company_idtarget_company_id, field_filtercompany_name,legal_person,credit_level,main_products,contact_person, need_businessTrue, need_qualificationFalse, need_supplyTrue, need_tradeTrue ) 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, indexFalse) else: print(f获取失败{result[error_msg]})四、调试与问题排查快速解决对接异常1. 优先用官方工具调试排除签名与参数问题登录志趣网开放平台调试工具选择zhiqu.item.get.company接口输入company_id、field_filter等参数点击 “生成签名” 并发送请求若官方工具调用成功 → 问题出在代码的签名生成逻辑或参数拼接错误如布尔参数未转小写、时间戳格式错误若官方工具调用失败 → 问题出在权限配置或参数有效性如company_id错误、IP 未加入白名单。2. 高频问题排查表问题现象常见原因解决方案签名验证失败4011. app_key/app_secret 错误或过期2. token 失效3. 参数未按 ASCII 升序排序4. timestamp 与服务器时差 5 分钟1. 核对开放平台密钥信息过期则重新申请2. 调用token_get接口刷新 token3. 严格按参数名 ASCII 升序排序所有非空参数4. 同步服务器时间确保时间戳误差≤5 分钟权限不足4031. 未申请item_get.company接口权限2. 服务器 IP 不在白名单3. 调用频率超限4. 访问敏感信息无高级权限1. 在开放平台 “权限管理” 中申请接口2. 添加服务器公网 IP 到应用白名单3. 降低调用频率控制并发数≤权限上限4. 提交资质备案申请高级权限参数错误4001. company_id 为空或格式非法2. field_filter 字段格式错误如用分号分隔3. company_id 对应的公司已注销1. 确保传入有效的 company_id格式为ZQ日期序号2.field_filter字段用英文逗号分隔3. 在志趣网官网搜索company_id验证公司状态无数据返回200 但 data 为空1. 公司已注销 / 违规2. 公司为新注册且无公开信息3. field_filter 参数传入错误字段1. 更换有效 company_id 测试2. 联系公司完善平台信息3. 去掉field_filter参数测试全字段返回结果响应超时5041. 网络波动或服务器负载高2. need_qualificationtrue 且资质数据量大3. 高峰期调用工作日 9:00-12:00/14:00-18:001. 添加重试机制设置超时时间为 15 秒2. 非必要时关闭need_qualification参数3. 避开高峰期调用分批次获取数据五、进阶优化生产级稳定性提升1. 性能与配额优化批量调用优化多公司 ID 查询时采用异步并发框架如 Python 的aiohttp并发数严格控制在权限允许的频率上限内如企业基础权限 3 次 / 秒避免同步循环调用导致的效率低下。智能缓存策略用 Redis 缓存公司详情数据缓存 key 设计为zhiqu_company_公司ID_字段过滤参数缓存时间区分数据类型工商基础数据缓存 24 小时经营资质与信用数据缓存 12 小时供应能力与交易数据缓存 5 分钟缓存失效触发条件当接口返回公司经营状态或信用等级发生变化时主动更新缓存。字段按需加载前端详情页采用懒加载策略首屏仅请求核心字段公司名称 / 法人 / 信用等级用户点击 “资质证书” 时再请求qualification_urls字段用户点击 “供应能力” 时再请求main_products/annual_supply字段减少单次请求的数据体积提升响应速度。2. 数据质量优化数据清洗与标准化按company_id去重避免重复存储同一公司数据过滤异常值如注册资本为 0、成立时间为空的公司统一字段格式如成立时间统一为 “YYYY - MM - DD” 格式信用等级统一为大写缺失值填充如无法人信息填充为 “暂无”无供应区域填充为 “全国”。数据一致性校验定期对比接口返回数据与本地缓存数据当公司经营状态、信用等级等关键字段发生变化时触发业务告警如公司经营状态异常提醒。3. 合规与安全优化密钥与 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中的工商信息、资质证书数据搭建企业合规审核平台自动核验入驻企业合规性提高审核效率