下载文件
GET /files/{filePath}?v={md5}
返回文件二进制内容,支持 Range 断点续传。
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
filePath | Path | string | 是 | 相对文件路径,例如 /core_ets2mp.dll |
v | Query | string | 是 | 文件 MD5,用于避免旧缓存 |
正确示例
https://tmplistoss.bgydook.cn/files/core_ets2mp.dll?v=19ea3558eddc0cc7eaecd8dc68197b3e
嵌套路径:
https://tmplistoss.bgydook.cn/files/data/ets2/mods/data_mp.mp?v=c1d1d49d00fa0a115921180aa80ed8f1
cURL
curl -L \
-o core_ets2mp.dll \
"https://tmplistoss.bgydook.cn/files/core_ets2mp.dll?v=19ea3558eddc0cc7eaecd8dc68197b3e"
响应头
Content-Type: application/x-msdownload
Content-Length: 16995328
Content-Disposition: attachment; filename*=UTF-8''core_ets2mp.dll
Accept-Ranges: bytes
为什么要加 v
文件名称不变,但内容会随 TMP 更新。只请求 /files/... 时,浏览器或反向代理可能命中旧缓存。
加入文件 MD5 后:
文件没更新 -> MD5 不变 -> 继续使用缓存
文件已更新 -> MD5 变化 -> URL 变化 -> 自动获取新文件
:::danger 不要使用裸地址 下面这个地址是不完整的:
https://tmplistoss.bgydook.cn/files/core_ets2mp.dll
客户端必须从文件列表读取 downloadUrl,或自行追加:
?v={md5}
:::