接入文档
接口简介
本接口提供基于基金代码的公告数据检索服务。开发者传入目标基金代码,即可获取该基金发布的各类公告列表,包含公告发布日期、完整标题及正文内容。接口支持分页查询,便于按需拉取历史数据。
适用场景
- 金融资讯聚合:为理财APP或网站提供特定基金的最新披露信息。
- 投研数据分析:自动化采集基金季报、年报及临时公告,用于舆情监控或基本面分析。
- 合规审计辅助:快速回溯特定时间段内的基金披露记录,满足内部合规检查需求。
请求与返回说明
请求方式:POST 核心参数:
fundCode(必填):目标基金的六位代码。pageNo(选填):页码,默认为1。pageSize(选填):每页条数,默认10,最大支持50。
返回结果: 成功时返回标准JSON结构,data.list 数组中包含多条公告对象,每个对象包含:
date:公告发布时间。title:公告完整标题。content:公告正文文本。
同时返回 total 总记录数,便于前端实现分页逻辑。
接入建议
- 缓存策略:基金公告属于低频更新数据,建议对已获取的历史公告进行本地缓存,减少重复请求。
- 分页处理:首次加载可仅请求第一页,用户触发“加载更多”时再异步请求后续页面,优化响应速度。
- 异常处理:请校验返回码
code,若为200则解析data字段,否则根据msg提示用户或记录日志。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码",
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"total": 207,
"limit": 10,
"page": 1,
"list": [
{
"date": "2024-07-18 00:00:00",
"title": "中航混改精选混合型证券投资基金2024年第2季度报告",
"content": "中航混改精选混合型证券投资基金\n 2024 年第 2 季度报告\n\nXXXXXXX"
}
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| properties.pageNo | object | {...} |
| properties.pageNo.type | string | string |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.code | object | {...} |
| properties.code.type | string | number |
| properties.code.example | number | 200 |
| properties.code.description | string | 返回码,详见返回码说明 |
| properties.msg | object | {...} |