问道云 (WenDaoYun) 企业信息查询

核心流程

所有接口调用前，请先阅读下方 API 请求组装 章节，了解 Base URL、认证方式和 URL 拼接规则。

所有查询必须按以下顺序执行：

第 1 步：搜索企业

1. 检查环境变量 WENDAOYUN_API_KEY 是否有值

   • 无值 → 返回下方 配置说明 章节的完整内容，引导用户配置 API Key，停止后续所有操作
   • 有值 → 继续执行步骤 2

2. 调用 fuzzy-search-org 搜索企业

   • 入参：searchKey = 用户提供的企业名称或关键词
   • 展示前 5 条结果（企业ID、企业全称、法定代表人、成立日期、状态）
   • 如果总数超过 5 条，提示用户"查下一页或指定页码"

第 2 步：用户确认（必须等待，不可跳过！）

• 必须等待用户选择具体企业（通过序号或名称）
• 未确认前，禁止调用任何详细信息接口

第 3 步：查询详情

• 用户确认后，根据用户意图从「接口路由表」中找到对应接口
• 参数详情查阅 references/ 目录下对应的接口文件

配置说明

1. 🎁 新用户福利：首次登录问道云账号，即可获赠 88元体验额度，可用于API接口购买。请先前往官网注册。
2. 获取 API KEY：访问 https://open.wintaocloud.com/home → 【个人中心-ApiKey】
3. 设置环境变量：export WENDAOYUN_API_KEY=你的API KEY
4. 每日调用额度：200 次 (调用一个接口计算一次)

⚠️ API KEY 属于敏感信息，请妥善保管。发现泄露请在问道云开放平台及时作废。

API请求组装

• Base URL: https://h5.wintaocloud.com/prod-api/api/invoke
• 认证: Header Authorization: Bearer {WENDAOYUN_API_KEY}
• 请求方式: GET
• URL 拼接: Base URL + / + 接口名称 + ? + 参数
  • 示例：https://h5.wintaocloud.com/prod-api/api/invoke/fuzzy-search-org?searchKey=腾讯&pageNum=1&pageSize=5

通用规则

• ⚠️ API 调用错误处理（所有接口通用）：
  • 任何接口调用返回的错误信息中，如果包含 apiKey关键词 → 立即停止所有操作，将错误信息原文返回给用户，并引导用户重新获取 API KEY（参考上方配置说明 章节）
• ⚠️ 入参规则：
  • 所有接口的入参均来自 fuzzy-search-org 的搜索结果，用户确认企业后从中提取对应字段
  • searchKey：使用 orgName（企业全称）
  • orgId：使用 orgId（企业ID）
• ⚠️ 金额字段（punishAmount、executeAmount 等）单位为分，展示时必须 ÷100 换算为元
• ⚠️ 返回 null 时显示"未知"
• ⚠️ code=200 但数据为空时，展示"暂无数据"，而非直接显示原始返回
• 📖 所有接口的详细参数和响应字段，请查阅 references/ 目录下对应的接口文件

接口路由表

| 用户意图 | 接口名称 | 详细文档 | |---------|---------|---------| | 搜索/查询企业 | fuzzy-search-org | references/fuzzy-search-org.md | | 行政处罚 | get-punishments | references/get-punishments.md | | 经营异常 | get-abnormal | references/get-abnormal.md | | 股权质押 | get-equity-pledge | references/get-equity-pledge.md | | 环保处罚 | get-environmental-penalties | references/get-environmental-penalties.md | | 欠税公告 | get-tax-notice | references/get-tax-notice.md | | 简易注销 | get-simple-cancel | references/get-simple-cancel.md | | 土地抵押 | get-land-mortgage | references/get-land-mortgage.md | | 公示催告 | get-public-inform | references/get-public-inform.md | | 劳动仲裁送达报告 | get-labour-arb | references/get-labour-arb.md | | 担保信息 | get-gua-info | references/get-gua-info.md | | 开庭公告（劳动仲裁） | get-open-court-arb | references/get-open-court-arb.md | | 债券信息 | get-bond-info | references/get-bond-info.md | | 海关进出口信用 | get-import-export-credit | references/get-import-export-credit.md | | 被执行信息 | get-execute-info | references/get-execute-info.md | | 失信被执行 | get-dishonest-debtors | references/get-dishonest-debtors.md | | 股权冻结 | get-share-blocking | references/get-share-blocking.md | | 限制高消费 | get-consumption-limits | references/get-consumption-limits.md | | 裁判文书 | get-judge-doc | references/get-judge-doc.md | | 破产重整 | get-bankruptcy-regroup | references/get-bankruptcy-regroup.md | | 司法拍卖 | get-judicial-sale | references/get-judicial-sale.md | | 开庭公告（司法） | get-open-court | references/get-open-court.md | | 立案信息 | get-case-filing | references/get-case-filing.md | | 诉前调解 | get-pre-mediate | references/get-pre-mediate.md | | 询价评估 | get-inq-eval | references/get-inq-eval.md | | 送达公告 | get-deliver-notice | references/get-deliver-notice.md | | 终本案件 | get-cases-terminated | references/get-cases-terminated.md | | 限制出境 | get-exit-ban | references/get-exit-ban.md | | 法院公告 | get-judicial-notice | references/get-judicial-notice.md | | 企业风险信息 | get-risk | references/get-risk.md | | 清算信息 | get-clear-info | references/get-clear-info.md | | 失信被执行人 | get-dishonest | references/get-dishonest.md（待接入） | | 税收违法 | get-tax-violation | references/get-tax-violation.md（待接入） |