📥 文件下载接口

🔄 下载流程

📋 接口规格

1. 业务类型下载接口

接口说明

用于下载指定业务类型的文件，支持权限控制和业务隔离

请求信息

• 接口路径: /download/{业务类型代码}
• 请求方式: GET
• Content-Type: application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明	示例值
filePath	String	是	文件存储路径	/2024/08/25/23/file.apk
fileName	String	否	自定义下载文件名	示例应用.apk

请求示例

GET /download/demo?filePath=/2024/08/25/23/891dc10b-9b8f-4d1a-bdcd-a298bcc6dc0b.apk&fileName=示例应用.apk
Host: 127.0.0.1:9830

2. 默认下载接口

注意

默认下载接口不进行业务类型校验，请注意安全控制

请求信息

• 接口路径: /download
• 请求方式: GET
• Content-Type: application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明	示例值
filePath	String	是	文件存储路径	/2024/08/25/23/file.apk
fileName	String	否	自定义下载文件名	示例应用.apk

请求示例

GET /download?filePath=/2024/08/25/23/891dc10b-9b8f-4d1a-bdcd-a298bcc6dc0b.apk&fileName=示例应用.apk
Host: 127.0.0.1:9830

💡 使用建议

1. 业务类型选择

   • 建议使用业务类型下载接口，便于权限管理
   • 默认下载接口适用于无需权限控制的场景

2. 文件命名

   • 建议使用 fileName 参数指定下载文件名
   • 文件名应包含正确的扩展名以支持客户端处理

3. 安全建议

   • 验证文件路径合法性
   • 控制文件下载权限
   • 限制下载文件大小
   • 添加下载频率限制