Index weight download

下载指数权重文件（index-weight-download）

1. 接口描述

项目	说明
接口名称	下载指数权重文件
外部接口	/api/v1/market/data/index/index_weight/{url_hash}
请求方式	GET
适用场景	根据「分页查询指数权重列表」或「分页查询指数权重汇总」返回的 url_hash 下载该期指数权重 Excel（xlsx）二进制文件

2. 请求参数

说明：url_hash 为路径参数，必填。

参数名	类型	是否必填	描述	取值示例	备注
url_hash	string	是	列表或汇总接口返回的 url_hash	xyz789	路径参数

3. 响应说明

成功时返回 Excel（xlsx） 二进制流。

• 成功：HTTP 200，响应体为 xlsx 文件字节流

4. 调用方式

本 handler 与上级 FTShare-index-data/run.py 配合使用：

python <RUN_PY> index-weight-download --url-hash <url_hash>
python <RUN_PY> index-weight-download --url-hash <url_hash> --output ./weights.xlsx

其中 <RUN_PY> 为 FTShare-index-data/run.py 的绝对路径。

• --output：仅允许保存到当前工作目录下的路径；不传则默认为 {url_hash}.xlsx。

直接执行 handler（调试）

python scripts/handler.py --url-hash <url_hash> --output ./weights.xlsx

5. 链路说明

本接口为权重链末端下载。
前置：index-weight-summary 的 periods[].url_hash 或 index-weight-list 的 url_hash → 传给本接口的 --url-hash。

6. 请求示例

GET /api/v1/market/data/index/index_weight/xyz789