芯化 MCP 开放平台

list_enterprise_annual_reports

列出企业年报(ads_enterprise_annual_report)。需 ent_id;可选 year 筛选年度。

英文描述

List enterprise annual report entries from ads_enterprise_annual_report. Use for 企业年报. Requires ent_id. Optional year filter (year_report field).

文档更新:2026-06-23T10:00:00+08:00

请求参数

参数名参数说明数据类型样例数据
ent_id必填;至少 1 个字符stringEN202401011234567890
year选填;至少 4 个字符string(选填,示例中省略)
limit选填integer20
offset选填integer0

响应参数

参数名参数说明数据类型样例数据
data业务记录数组array[{"ent_id": "EN202401011234567890", "report_year": "2023", "publish_date": "2024-05-30"}]
data[].ent_id企业 ent_idstringEN202401011234567890
data[].report_year年报年度string2023
data[].publish_date公示日期string2024-05-30
meta.total命中总数integer100
meta.limit本页 limitinteger20
meta.offset本页 offsetinteger0
meta.has_more是否还有下一页booleantrue

响应状态说明

状态说明
success调用成功,返回业务数据
failed参数错误、后端业务错误或系统异常
deniedAPI Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "ent_id": "EN202401011234567890",
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "ent_id": "EN202401011234567890",
      "report_year": "2023",
      "publish_date": "2024-05-30"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}