问道云 (WenDaoYun) 企业信息查询
配置说明
- 获取 API Key:打开 https://open.wintaocloud.com/home,登录后在个人中心或开发者中心获取
- 一个用户可以拥有多个 API Key
- 配置文件(任选其一):
~/.config/wendao-yun/config.json- 工作空间根目录
wendao-yun-config.json格式:{ "api_key": "你的Key" }
- 或设置环境变量:
export WENDAOYUN_API_KEY=你的Key - 每日调用额度 200 次
⚠️ API Key 属于敏感信息,请妥善保管,不要泄露给他人。发现泄露请及时在问道云开放平台作废。
查询流程
所有查询都遵循:搜索企业 → 用户确认 → 查询详情
第 1 步:用户提出需求(如"查腾讯的行政处罚")
第 2 步:调用 fuzzy-search-org 搜索企业,列出前 5 条;如果 total 超过 5 条,告知用户可以"查下一页或指定页码"
第 3 步:必须等待用户确认具体企业,不要跳过!
第 4 步:调用对应详细信息接口
接口速查
| 用户说法 | 接口 | 状态 |
|---|---|---|
| 查询 XX 企业 | fuzzy-search-org |
✅ |
| XX 的行政处罚 | get-punishments |
✅ |
| XX 是不是老赖 / 失信被执行人 | get-dishonest |
⏳ |
| XX 经营异常 | get-abnormal |
✅ |
| XX 股权质押 | get-equity-pledge |
✅ |
| XX 环保处罚 | get-environmental-penalties |
✅ |
| XX 欠税公告 | get-tax-notice |
✅ |
| XX 简易注销 | get-simple-cancel |
✅ |
| XX 土地抵押 | get-land-mortgage |
✅ |
| XX 清算信息 | get-clear-info |
✅ |
| XX 公示催告 | get-public-inform |
✅ |
| XX 劳动仲裁送达报告 | get-labour-arb |
✅ |
| XX 担保信息 | get-gua-info |
✅ |
| XX 开庭公告 | get-open-court-arb |
✅ |
| XX 税收违法 | get-tax-violation |
⏳ |
API 基础信息
- Base URL:
https://h5.wintaocloud.com/prod-api/api/invoke - 认证: Header 填写
Authorization: Bearer {api_key} - 请求方式: 全部 GET
- 金额字段: punishAmount、assureAmount、mortgageAmount 等单位为分,展示时÷100换算为元
- 金额字段可能返回 null,展示时应显示"未知"而非 null
fuzzy-search-org - 企业模糊搜索
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| searchKey | string | 是 | 关键词(最少 2 字符) |
| pageNum | integer | 否 | 页码,默认 1,每页 5 条 |
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| orgId | string | 企业ID |
| orgName | string | 企业名称 |
| usCreditCode | string | 统一社会信用代码 |
| incDate | string | 成立日期 |
| legalName | string | 法定代表人 |
| status | string | 企业状态(存续/在业等) |
| address | string | 企业地址 |
使用说明:结果可能很多(如"腾讯"返回近万条),始终只展示前 5 条,展示时必须包含序号、企业全称、法定代表人、成立日期、状态。必须询问用户确认。
get-punishments - 行政处罚
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| searchKey | string | 是 | 企业全称 |
| pageNum | integer | 否 | 页码,默认 1 |
| pageSize | integer | 否 | 每页条数,默认 10,最大 20 |
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| punishNo | string | 行政处罚决定文书号 |
| illegalFact | string | 违法事实 |
| punishResult | string | 处罚结果 |
| unitName | string | 作出处罚单位名称 |
| punishTime | string | 处罚日期 |
| punishAmount | integer | 处罚金额(单位:分,换算需÷100才是元) |
get-abnormal - 经营异常
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| searchKey | string | 是 | 企业全称 |
响应字段: | 字段 | 类型 | 说明 | |------|------|------|------| | department | string | 列入部门 | | abnormalDate | string | 列入日期 | | abnormalReason | string | 列入原因 | | removeDepartment | string | 移出部门 | | removeDate | string | 移出日期 | | removeReason | string | 移出原因 |
以下接口请求参数均同 get-equity-pledge
searchKey(必填,string)、pageNum(否,integer)、pageSize(否,integer,默认10,最大20)
get-equity-pledge - 股权质押
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| pledgeeNameList | list | 质权人列表 [{name, type}] |
| riskState | string | 股权质押状态 |
| publicTime | string | 公告日期 |
| pledgeName | string | 出质人名称 |
get-environmental-penalties - 环保处罚
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| punishBehavior | string | 违法事实 |
| punishAmount | integer | 处罚金额(单位:分) |
| punishInstitution | string | 作出处罚单位名称 |
| publishDate | string | 发布日期 |
| punishDate | string | 处罚日期 |
| punishNumber | string | 环保处罚决定书文号 |
get-tax-notice - 欠税公告
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| taxDepartment | string | 发布单位 |
| publishDate | string | 发布日期 |
| taxCategory | string | 欠税税种 |
| newOwnTaxBalance | integer | 当前发生新欠税余额(单位:分) |
| ownTaxBalance | integer | 欠税余额(单位:分) |
get-simple-cancel - 简易注销
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| result | string | 简易注销结果 |
| publicDate | string | 公告日期 |
| regInstitute | string | 登记机关 |
| usCreditCode | string | 统一社会信用代码 |
| orgName | string | 企业名称 |
| objectionList | list | 异议信息 [{objectionDate, content, objectionName}] |
| promiseUrl | string | 全体投资人承诺书Url |
get-land-mortgage - 土地抵押
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| mortgageAmount | integer | 抵押金额(单位:分) |
| mortgageBeginTime | string | 抵押开始日期 |
| mortgageEndTime | string | 抵押结束日期 |
| mortgageArea | string | 抵押面积 |
| address | string | 地址 |
get-public-inform - 公示催告
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| publishAuthority | string | 发布机关名称 |
| billType | string | 票据类型 |
| faceValue | integer | 票面金额 |
| publishDate | string | 公告日期 |
| orgName | string | 企业名称 |
| billNumber | string | 票据号 |
get-labour-arb - 劳动仲裁送达报告
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| publishDate | string | 公告日期 |
| applicantName | string | 原告名称 |
| respondentName | string | 被告名称 |
| caseNo | string | 案号 |
get-gua-info - 担保信息
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| assureAmount | integer | 担保金额(单位:分,换算需÷100才是元) |
| assureBeginTime | string | 担保起始日 |
| assureEndTime | string | 担保终止日 |
| assureTerm | string | 担保期限(年) |
| assureName | string | 担保方式 |
| currency | string | 币种 |
| performState | string | 履行状态 |
| isRpt | string | 是否关联交易 |
| assuredEntityName | string | 被担保方名称 |
| assureEntityName | string | 担保方名称 |
| reportDate | string | 报告期 |
| transactionDate | string | 交易日期 |
| assureDealTime | string | 处理日期 |
get-open-court-arb - 开庭公告(劳动仲裁)
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| courtOpenTime | string | 开庭日期 |
| caseReason | string | 案由 |
| plaintiffName | string | 原告名称 |
| defendantName | string | 被告名称 |
| caseNo | string | 案号 |
| undertakeDept | string | 承办部门名称 |
| dataOpenCourtId | long | 开庭公告ID |
get-clear-info - 清算信息
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| searchKey | string | 是 | 企业全称 |
响应字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| liquidationLeader | string | 清算组负责人名称 |
| liquidationMembers | string | 清算组成员 |
待接入接口
get-dishonest- 失信被执行人get-tax-violation- 税收违法
关键原则
- ✅ 所有详细查询都必须先搜索、再确认、后查询
- ❌ 不要在未确认企业时直接调用详细信息接口
- ⚠️ 金额字段单位为分,展示时需÷100换算为元;返回 null 时显示"未知"
