📤 文件上传接口

🔄 上传流程

📋 接口规格

1. 业务类型上传接口

接口说明

用于上传文件到指定业务类型，支持多服务场景下的业务数据隔离

请求信息

• 接口路径: /upload/{业务类型代码}
• 请求方式: POST
• Content-Type: multipart/form-data

请求参数

参数名	类型	必填	说明	示例值
file	File	是	上传的文件对象	example.apk

响应结果

{
    "code": 0,                // 错误码：0-成功，其他-失败
    "successful": true,       // 是否成功
    "msg": null,             // 错误信息
    "data": {
        "filePath": "/2024/08/25/23/891dc10b-9b8f-4d1a-bdcd-a298bcc6dc0b.apk",  // 文件存储路径
        "fileName": "example.apk"  // 文件名称
    }
}

2. 默认上传接口

注意

默认上传接口使用第一个文件配置，适用于单一业务服务场景

请求信息

• 接口路径: /upload
• 请求方式: POST
• Content-Type: multipart/form-data

请求参数

参数名	类型	必填	说明	示例值
file	File	是	上传的文件对象	example.apk

响应结果

{
    "code": 0,                // 错误码：0-成功，其他-失败
    "successful": true,       // 是否成功
    "msg": null,             // 错误信息
    "data": {
        "filePath": "/2024/08/25/23/891dc10b-9b8f-4d1a-bdcd-a298bcc6dc0b.apk",  // 文件存储路径
        "fileName": "example.apk"  // 文件名称
    }
}

💡 使用建议

1. 业务类型选择

   • 多服务场景建议使用业务类型上传接口
   • 单一服务场景可使用默认上传接口

2. 文件上传限制

   • 注意文件大小限制
   • 检查允许的文件类型
   • 考虑文件名长度限制

3. 安全建议

   • 验证文件内容类型
   • 实施上传频率控制
   • 进行文件病毒扫描
   • 使用安全的存储路径