FTShare-Lab 分页查询指数权重汇总（index-weight-summary）
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 分页查询指数权重汇总 |
| 外部接口 | /api/v1/market/data/index/index_weight_summary |
| 请求方式 | GET |
| 适用场景 | 按指数汇总各期权重数据的 date 与 url_hash；可用 index_code 定位单个指数，便于再调用「下载指数权重文件」获取具体权重表 |
2. 请求参数
说明：使用查询参数。
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| index_code | string | 否 | 指数代码 | 000300 | 不传则分页返回全部指数 |
| page | int | 否 | 页码 | 1 | 默认 1 |
| page_size | int | 否 | 每页条数 | 20 | 默认 20，最大 100 |
3. 响应说明
返回值为分页列表对象 IndexWeightSummaryListResponse。
IndexWeightSummaryListResponse 结构
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| total | int | 否 | 总条数（按指数汇总的记录数） | - |
| page | int | 否 | 当前页码 | - |
| page_size | int | 否 | 每页条数 | - |
| index_weights | array | 否 | 单只指数的期数汇总列表 | - |
IndexWeightSummary 结构（index_weights 元素）
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| index_code | String | 否 | 指数代码 | - |
| periods | array | 否 | 该指数各期的日期与下载用 url_hash | - |
IndexWeightPeriod 结构（periods 元素）
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| date | String | 否 | 权重日期；文档示例为 YYYYMMDD，线上也可能为 YYYY-MM-DD，以实际返回为准 |
- |
| url_hash | String | 否 | 该期权重文件的哈希 | - |
4. 调用方式
本 handler 与上级 FTShare-index-data/run.py 配合使用：
python <RUN_PY> index-weight-summary --index-code 000300 --page 1 --page-size 20
python <RUN_PY> index-weight-summary --page 1 --page-size 20
其中 <RUN_PY> 为 FTShare-index-data/run.py 的绝对路径。
直接执行 handler（调试）
python scripts/handler.py --page 1 --page-size 20
python scripts/handler.py --index-code 000300 --page 1 --page-size 20
（需在 sub-skills/index-weight-summary 目录下执行，或传入脚本完整路径。）
5. 链路说明
本接口为权重链第 1 步。
- 取到
index_code+date→ 可调index-weight-list --index_code <code> --date <date>查成份明细。 - 取到
url_hash→ 可调index-weight-download --url-hash <url_hash>直接下载整期 xlsx。
6. 请求示例
GET /api/v1/market/data/index/index_weight_summary?index_code=000300&page=1&page_size=20