查询可下载文件列表
GET /api/tmp/files
返回当前服务器上实际存在,并且大小与索引一致的文件。
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
type | Query | string | 否 | system、ets2、ats、unknown,或 0/1/2/3 |
keyword | Query | string | 否 | 按文件路径模糊搜索,不区分大小写 |
请求示例
curl "https://tmplistoss.bgydook.cn/api/tmp/files?type=ets2"
响应示例
{
"code": 200,
"msg": "操作成功",
"data": [
{
"type": 2,
"typeName": "欧卡",
"md5": "19ea3558eddc0cc7eaecd8dc68197b3e",
"fileSize": 16995328,
"filePath": "/core_ets2mp.dll",
"downloadUrl": "/files/core_ets2mp.dll?v=19ea3558eddc0cc7eaecd8dc68197b3e",
"updateTime": "2026-10-18 10:00:00"
}
]
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 200 表示成功 |
msg | string | 响应说明 |
data | array | 文件列表 |
type | integer | 0 未知、1 系统、2 欧卡、3 美卡 |
typeName | string | 类型名称 |
md5 | string | 文件 MD5 |
fileSize | integer | 文件大小,单位字节 |
filePath | string | 相对文件路径 |
downloadUrl | string | 下载地址,已带 MD5 版本参数 |
updateTime | string | 服务器文件更新时间 |
:::warning 下载地址必须带 MD5
downloadUrl 可能是相对地址。客户端拼接域名时,必须保留其中的 ?v={md5}。
如果客户端自行拼接,也要使用:
https://tmplistoss.bgydook.cn/files{filePath}?v={md5}
:::
类型筛选
| 值 | 含义 |
|---|---|
system / 1 | 系统文件 |
ets2 / 2 | 欧卡 |
ats / 3 | 美卡 |
unknown / 0 | 未知类型 |