FTShare-Lab 分页查询指数权重列表（index-weight-list）
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 分页查询指数权重列表 |
| 外部接口 | /api/v1/market/data/index/index_weight |
| 请求方式 | GET |
| 适用场景 | 按指数代码（及可选日期）分页查询成份权重明细；每条记录含成份代码、名称、权重比例及该期文件 url_hash |
2. 请求参数
说明：使用查询参数。服务端校验 index_code 非空，否则返回错误。
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| index_code | string | 是 | 指数代码 | 000300 | 不能为空或仅空白 |
| date | string | 否 | 查询日期，格式 YYYYMMDD |
20250320 | 不传则由上游默认行为决定 |
| page | int | 否 | 页码 | 1 | 默认 1 |
| page_size | int | 否 | 每页条数 | 20 | 默认 20，最大 100 |
3. 响应说明
返回值为分页列表对象 IndexWeightListResponse。
IndexWeightListResponse 结构
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| total | int | 否 | 总条数 | - |
| page | int | 否 | 当前页码 | - |
| page_size | int | 否 | 每页条数 | - |
| index_weights | array | 否 | 权重明细列表 | - |
IndexWeightInfo 结构（index_weights 元素）
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| date | String | 否 | 权重日期，YYYYMMDD（线上也可能为其他日期字符串格式，以实际为准） |
- |
| index_code | String | 否 | 指数代码 | - |
| component_code | String | 否 | 成份证券代码 | - |
| component_name | String | 否 | 成份证券名称 | - |
| weight | String | 否 | 权重（字符串形式，与上游一致） | - |
| url_hash | String | 否 | 该期完整权重表文件的哈希，可用于下载 xlsx | - |
4. 调用方式
本 handler 与上级 FTShare-index-data/run.py 配合使用：
python <RUN_PY> index-weight-list --index-code 000300 --date 20250320 --page 1 --page-size 20
python <RUN_PY> index-weight-list --index-code 000300 --page 1 --page-size 20
其中 <RUN_PY> 为 FTShare-index-data/run.py 的绝对路径。
直接执行 handler（调试）
python scripts/handler.py --index-code 000300 --date 20250320 --page 1 --page-size 20
（需在 sub-skills/index-weight-list 目录下执行，或传入脚本完整路径。）
5. 链路说明
本接口为权重链第 2 步。
- 前置：
index-weight-summary→ 取得index_code与可用date。 - 下游：返回的
url_hash→index-weight-download --url-hash <url_hash>下载整期 xlsx。
名称→代码映射
--index-code 只接受纯 6 位指数代码（如 000300），不接受中文名称。
若用户给出中文名称（如"沪深300"），须先映射：
- 调用
index-description-paginated --page 1 --page-size 100→ 在index_descriptions中按index_name模糊匹配 → 取得index_code。 - 或调用
index-description-all→ 从symbol（如000300.XSHG）截取前 6 位。
6. 请求示例
GET /api/v1/market/data/index/index_weight?index_code=000300&date=20250320&page=1&page_size=20