name: beawan-stock-report description: 查询A股上市公司财务报告分析地址，支持一季报、中报、三季报、年报 version: 1.0.0 author: beawan

碧湾股票报告查询

查询A股上市公司的财务报告分析地址。

配置

使用前需要设置您的 APIKEY：

先去应用市场下载碧湾App，登录后点击头像->碧湾Skills获取

APIKEY: <your-api-key>

接口说明

查询报告地址

GET http://api.beawan.com/beawanSkill/api/skill/report
Header: X-API-KEY: <your-api-key>

参数：

报告类型取值：一季报 / 中报 / 三季报 / 年报

参数说明

• ‌type‌ (string, required): 报告类型的中文名称。
  • ‌重要‌：请直接传递中文字符串，例如 "中报"、"年报"。
  • ‌禁止‌：不要传递十六进制编码（如 0xe4...）、Unicode 转义序列或 URL 编码后的字符串。
  • ‌示例‌：如果用户查询“中报”，参数值应为 "中报"。

返回示例：

{
  "code": 0,
  "data": {
    "url": "http://api.beawan.com/industry/html/load?name=jm43RF6Yb*K8GjWoO9VbDYxmHGa5rwppT97kMmM4mgM="
  }
}

使用示例

查询平安银行 2024 年年报：

GET http://api.beawan.com/beawanSkill/api/skill/report?comCode=000001&year=2024&type=年报
X-API-KEY: sk-your-api-key-here

查询贵州茅台 2024 年中报：

GET http://api.beawan.com/beawanSkill/api/skill/report?comCode=600519&year=2024&type=中报
X-API-KEY: sk-your-api-key-here

文档组织得当，接口和参数说明详尽，对中文编码的特殊提示很贴心。两个实际查询示例让功能一目了然。不过功能相对单一，缺少常见问题解答和错误处理指南，版本号也需确认统一。整体而言文档质量不错，功能实用，但细节还需打磨。