企业官网建设流程全解析

烟台建站服务,net asp网站开发,企业营销网站建设步骤,企管宝天眼查item_get接口#xff08;官方规范名称为企业基本信息接口 baseinfoV2#xff09;是通过企业名称、统一社会信用代码、注册号或企业 ID 获取企业工商基础信息、联系方式、经营状态、变更记录等结构化数据的核心接口#xff0c;适配企业征信、供应商筛选、风控合规等场景…天眼查item_get接口官方规范名称为企业基本信息接口 baseinfoV2是通过企业名称、统一社会信用代码、注册号或企业 ID 获取企业工商基础信息、联系方式、经营状态、变更记录等结构化数据的核心接口适配企业征信、供应商筛选、风控合规等场景天眼查开放平台。该接口采用HTTPSToken 认证数据源自工商登记、官方备案等权威渠道具备字段完整、更新实时、权限分级严格的特点天眼查开放平台。本攻略从接口认知、权限获取、实操对接、调试排错到生产级优化提供全链路结构化指导兼顾入门易用性与企业级稳定性。一、接口核心认知功能与适配场景1. 接口定位与核心价值核心功能输入企业名称、统一社会信用代码、注册号或企业 IDkeyword 参数返回企业基础工商信息、联系方式、经营状态、变更记录、股权结构需进阶权限等核心数据支持关联查询企业历史名称、分支机构等信息天眼查开放平台。天眼查数据特性权威合规数据来自工商登记、官方备案等权威渠道符合《企业信息公示暂行条例》等法规要求天眼查开放平台字段完整覆盖企业基础工商、联系方式、经营状态、变更记录等多维度数据字段与国家企业信用信息公示系统一致更新实时基础工商信息缓存 24 小时经营状态、变更记录实时同步权限分级基础信息开放度高敏感数据如股权结构、财务数据需企业授权或高级权限。典型应用场景供应商筛选系统查询合作企业资质、经营状态降低合作风险企业征信平台聚合企业工商、资质、信用数据生成征信报告风控系统实时监控合作企业经营状态预警异常变更如法人变更、经营异常。2. 核心参数与返回字段1请求参数GET 方式提交需携带 Token 请求头天眼查开放平台参数类型参数名称类型是否必填说明应用示例请求头参数Authorizationstring是接口调用 Token开放平台获取Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...查询参数keywordstring是搜索关键字企业名称、统一社会信用代码、注册号或企业 ID需 URL 编码江西新余废旧物资回收有限公司/91360502MA398XXXXfieldsstring否需返回字段列表逗号分隔regStatus,legalPerson,businessScope,contactInfoneed_changeint否是否返回变更记录1 是0 否默认 01注意事项keyword需 URL 编码避免中文或特殊字符导致参数解析错误天眼查开放平台Token 有效期通常为 24 小时需定期刷新接口支持 GET 请求参数需拼接在 URL 中请求头携带 Authorization Token天眼查开放平台。2返回核心字段按业务场景分类天眼查开放平台字段分类核心字段说明基础工商信息name企业名称regNo注册号creditCode统一社会信用代码regStatus经营状态存续 / 注销 / 吊销 / 经营异常regCapital注册资本万元establishTime成立日期legalPerson法定代表人businessScope经营范围regAddress注册地址companyType企业类型联系方式contactPhone联系电话contactEmail联系邮箱website企业官网变更与历史historyNames历史名称changeRecord变更记录需 need_change1信用与风险riskFlag是否有风险记录0 否1 是blacklistFlag是否列入黑名单0 否1 是分页与状态updateTime数据更新时间cacheTime缓存有效期秒提示item_get接口不返回财务数据需调用finance.get等扩展接口获取需企业授权。3. 接口限制与注意事项调用频率与配额限制| 权限类型 | 日调用上限 | 调用频率 | 适用场景 ||----------|------------|----------|----------|| 个人测试权限 | 100 次 / 天 | 2 次 / 秒 | 功能调试、个人研究 || 企业基础权限 | 1000 次 / 天 | 5 次 / 秒 | 中小型企业供应商筛选、市场调研 || 企业高级权限 | 10000 次 / 天 | 20 次 / 秒 | 大型征信平台、风控系统、行业数据统计 |数据缓存规则基础工商信息缓存 24 小时变更记录、经营状态实时同步内容限制未公示企业、注销企业、列入异常名录且未公示企业不返回敏感数据合规要求数据仅用于合规企业征信、供应商筛选、市场调研等业务遵守《企业信息公示暂行条例》《个人信息保护法》等法规严禁用于非法用途。二、对接前准备权限与环境搭建1. 获取接口权限官方唯一合规路径天眼查开放平台天眼查item_get接口由天眼查开放平台提供接入步骤如下登录天眼查开放平台注册企业账号提交资质审核企业营业执照、法人身份证、应用用途说明等材料创建应用填写应用名称、用途、服务器 IP 等信息提交审核审核通过后获取access_token接口调用核心凭证配置 IP 白名单申请baseinfoV2item_get接口权限根据业务需求选择权限等级基础 / 进阶 / 高级。风险提示严禁使用非合规爬虫、第三方接口抓取企业数据违反平台协议与法规存在账号封禁、法律追责风险。2. 技术环境准备1支持语言与协议协议HTTPS强制HTTP 请求会被拦截开发语言Python、Java、PHP、Go 等主流语言推荐 Python适配 Token 管理与复杂数据解析。2必备工具与依赖工具类型推荐工具用途调试工具天眼查官方调试工具自动生成 Token验证接口参数与响应Postman模拟 GET 请求排查代码逻辑问题URL 编码工具对 keyword 参数进行 URL 编码确保格式正确开发依赖requests发送 HTTPS GET 请求jsonpath-ng快速解析嵌套 JSON 响应pandas批量整理企业详情数据辅助工具Redis缓存企业详情数据减少接口调用次数logging记录接口调用日志便于审计与问题追溯三、实操步骤接口对接全流程Python 示例步骤 1理解 Token 认证规则核心必掌握天眼查接口采用Token 认证机制流程如下登录天眼查开放平台创建应用并获取client_id和client_secret调用token接口获取access_token每次调用item_get接口时在请求头中携带Authorization: Bearer {access_token}access_token有效期 24 小时需定期刷新。步骤 2完整代码实现含 Token 获取 调用 数据标准化1依赖安装bashpip install requests pandas jsonpath-ng2Python 代码实现import requests import time import pandas as pd import logging from urllib.parse import quote from jsonpath_ng import parse # 封装好API供应商demo urlhttps://console.open.onebound.cn/console/?iLex # 日志配置 logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[logging.FileHandler(tianyancha_item_get.log), logging.StreamHandler()] ) # 配置信息替换为你的天眼查开放平台信息 CONFIG { client_id: 你的client_id, client_secret: 你的client_secret, token_url: https://open.api.tianyancha.com/services/open/token/2.0, item_get_url: https://open.api.tianyancha.com/services/open/ic/baseinfoV2/2.0, token_expire_time: 0 # Token过期时间秒 } def get_access_token() - str: 获取天眼查access_token处理过期自动刷新 current_time int(time.time()) if CONFIG[token_expire_time] current_time: return CONFIG.get(access_token, ) try: response requests.post( urlCONFIG[token_url], data{ grant_type: client_credentials, client_id: CONFIG[client_id], client_secret: CONFIG[client_secret] }, timeout10, verifyTrue ) response.raise_for_status() result response.json() if result.get(error): error_msg f{result.get(error)}: {result.get(error_description)} logging.error(fToken获取失败{error_msg}) return access_token result.get(access_token, ) expires_in result.get(expires_in, 86400) # 默认24小时 CONFIG[access_token] access_token CONFIG[token_expire_time] current_time expires_in - 300 # 提前5分钟刷新 return access_token except requests.exceptions.RequestException as e: logging.error(fToken请求异常{str(e)}) return except Exception as e: logging.error(fToken解析异常{str(e)}) return def standardize_ent_data(raw_ent: dict) - dict: 标准化天眼查企业详情数据统一输出格式 return { 企业名称: raw_ent.get(name, ), 统一社会信用代码: raw_ent.get(creditCode, ), 经营状态: raw_ent.get(regStatus, ), 注册资本(万元): raw_ent.get(regCapital, 0), 成立日期: raw_ent.get(establishTime, ), 法定代表人: raw_ent.get(legalPerson, ), 经营范围: raw_ent.get(businessScope, ), 注册地址: raw_ent.get(regAddress, ), 联系电话: raw_ent.get(contactPhone, ), 联系邮箱: raw_ent.get(contactEmail, ), 企业官网: raw_ent.get(website, ), 历史名称: raw_ent.get(historyNames, ), 是否有风险记录: raw_ent.get(riskFlag, 0), 是否黑名单: raw_ent.get(blacklistFlag, 0), 数据更新时间: raw_ent.get(updateTime, ), 请求时间: time.strftime(%Y-%m-%d %H:%M:%S, time.localtime()) } def tianyancha_item_get( keyword: str, fields: str None, need_change: int 0 ) - dict: 调用天眼查item_get接口获取企业详情 access_token get_access_token() if not access_token: return {success: False, error_msg: Token获取失败, data: {}} # 构建请求参数 params {keyword: quote(keyword, encodingutf-8)} if fields: params[fields] fields if need_change: params[need_change] 1 headers {Authorization: fBearer {access_token}} try: # 发送GET请求 response requests.get( urlCONFIG[item_get_url], paramsparams, headersheaders, timeout10, verifyTrue ) response.raise_for_status() result response.json() # 解析响应结果 if result.get(error): error_msg f{result.get(error)}: {result.get(error_description)} logging.error(f接口调用失败关键词{keyword}{error_msg}) return {success: False, error_msg: error_msg, data: {}} raw_ent result.get(result, {}) if not raw_ent: logging.warning(f无企业数据返回关键词{keyword}) return {success: False, error_msg: 无企业数据, data: {}} # 标准化数据 standard_data standardize_ent_data(raw_ent) return { success: True, data: standard_data, error_msg: } except requests.exceptions.RequestException as e: logging.error(f网络请求异常关键词{keyword}{str(e)}) return {success: False, error_msg: f网络异常{str(e)}, data: {}} except Exception as e: logging.error(f数据解析异常关键词{keyword}{str(e)}) return {success: False, error_msg: f解析异常{str(e)}, data: {}} # 封装好API供应商demo urlhttps://console.open.onebound.cn/console/?iLex # 调用示例 if __name__ __main__: keyword 江西新余废旧物资回收有限公司 fields name,creditCode,regStatus,legalPerson,businessScope need_change 0 result tianyancha_item_get(keywordkeyword, fieldsfields, need_changeneed_change) if result[success]: print(天眼查企业详情) for k, v in result[data].items(): print(f{k}: {v}) # 保存为Excel df pd.DataFrame([result[data]]) df.to_excel(ftianyancha_ent_detail_{keyword}.xlsx, indexFalse) else: print(f获取失败{result[error_msg]})四、调试与问题排查快速解决对接异常1. 优先用官方工具调试排除 Token 问题登录天眼查开放平台调试工具选择baseinfoV2item_get接口输入关键词、fields 等参数工具自动生成 Token发送请求查看响应结果。若官方工具调用成功说明代码 Token 管理或参数解析逻辑有误若失败检查权限或参数。2. 高频问题排查表问题现象常见原因解决方案Token 验证失败4011. client_id/client_secret 错误2. Token 过期3. Token 格式错误1. 核对平台应用信息2. 调用 get_access_token 刷新 Token3. 确保 Authorization 头格式为 “Bearer {token}”权限不足4031. 未申请 baseinfoV2 接口权限2. IP 不在白名单3. 企业资质未审核通过1. 在开放平台申请对应权限2. 添加服务器 IP 到白名单3. 补充资质材料完成审核参数错误4001. keyword 为空2. keyword 未 URL 编码3. fields 参数格式错误1. 确保 keyword 参数非空2. 对中文 keyword 进行 URL 编码3. fields 参数用逗号分隔字段名无企业数据返回1. 关键词无匹配2. 企业已注销 / 吊销3. 企业为敏感行业如军工数据未开放1. 核对关键词是否准确2. 在天眼查官网搜索关键词确认企业状态3. 敏感行业企业需特殊权限申请数据更新不及时1. 缓存未过期2. 数据同步延迟1. 等待缓存过期基础信息 24 小时2. 调用接口时添加force_refresh1参数需高级权限五、进阶优化生产级稳定性提升1. 性能与配额优化批量调用优化多企业查询时采用异步并发请求aiohttp控制并发数≤权限允许的频率上限如企业基础权限 5 次 / 秒智能缓存策略用 Redis 缓存企业详情缓存 key 为tianyancha_ent_关键词缓存有效期 24 小时空结果 5 分钟字段按需获取通过fields参数指定必要字段不获取无关数据减少响应体积与耗时。2. 数据质量优化数据一致性校验对比企业名称与统一社会信用代码校验数据准确性过滤异常数据字段标准化将非结构化字段如经营范围解析为行业标签便于后续数据分析关联数据适配建立企业 ID 与变更记录、分支机构的映射表自动关联多维度数据。3. 合规与安全密钥管理生产环境将client_id和client_secret存储在配置中心如 Nacos、Apollo禁止硬编码定期轮换密钥每 3 个月一次重试机制对 403频率超限、504超时等错误添加指数退避重试策略首次重试间隔 1 秒之后翻倍最多重试 3 次日志审计记录每次调用的关键词、参数、响应状态、数据更新时间保留至少 30 天日志满足合规审计要求。六、扩展场景接口联动与功能升级联动 item_search 接口通过关键词如 “江西新余 废旧物资回收”搜索获取企业列表再批量调用item_get获取详情实现 “搜索 - 详情” 全链路数据采集企业风控模型结合企业工商、经营、变更记录数据构建风控模型预警经营异常、资质过期等风险供应商管理系统对接企业 ERP 系统自动提取合作企业关键词调用item_get获取最新资质与经营状态实现供应商动态管理