datai/datai-scenes/datai-scene-salesforce/docs/api-docs/file/SysFileInfoController/0003-get-info.md

获取文件详细信息

接口信息

• 接口名称: 获取文件详细信息
• 接口路径: /file/info/{fileId}
• 请求方法: GET
• 模块归属: file
• 版本号: v1.0.0
• 创建日期: 2026-01-18
• 最后更新: 2026-01-18

功能描述

根据文件 ID 获取文件的详细信息，包括文件名、文件路径、存储类型、文件类型、文件大小、MD5 等信息。

请求参数

路径参数

参数名	类型	必填	描述	示例
fileId	Long	是	文件 ID	1

响应数据

成功响应

HTTP 状态码: 200 OK

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "fileId": 1,
    "fileName": "test.jpg",
    "filePath": "/upload/2026/01/18/1234567890_test.jpg",
    "storageType": "minio",
    "fileType": "jpg",
    "fileSize": 102400,
    "md5": "d41d8cd98f00b204e9800998ecf8427e",
    "createBy": "admin",
    "createTime": "2026-01-18T10:00:00",
    "updateBy": "admin",
    "updateTime": "2026-01-18T10:00:00",
    "delFlag": "0"
  }
}

字段名	类型	描述	示例
fileId	Long	文件主键	1
fileName	String	原始文件名	test.jpg
filePath	String	统一逻辑路径	/upload/2026/01/18/1234567890_test.jpg
storageType	String	存储类型	minio
fileType	String	文件类型/后缀	jpg
fileSize	Long	文件大小（字节）	102400
md5	String	文件MD5	d41d8cd98f00b204e9800998ecf8427e
createBy	String	创建人	admin
createTime	String	创建时间	2026-01-18T10:00:00
updateBy	String	更新人	admin
updateTime	String	更新时间	2026-01-18T10:00:00
delFlag	String	删除标志	0

失败响应

HTTP 状态码: 401 Unauthorized

{
  "code": 401,
  "msg": "没有权限访问",
  "data": null
}

HTTP 状态码: 404 Not Found

{
  "code": 404,
  "msg": "文件不存在",
  "data": null
}

接口示例

请求示例

curl -X GET "http://localhost:8080/file/info/1" \
  -H "Authorization: Bearer [token]"

响应示例

成功:

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "fileId": 1,
    "fileName": "test.jpg",
    "filePath": "/upload/2026/01/18/1234567890_test.jpg",
    "storageType": "minio",
    "fileType": "jpg",
    "fileSize": 102400,
    "md5": "d41d8cd98f00b204e9800998ecf8427e",
    "createBy": "admin",
    "createTime": "2026-01-18T10:00:00",
    "updateBy": "admin",
    "updateTime": "2026-01-18T10:00:00",
    "delFlag": "0"
  }
}

错误处理

• 没有权限访问时返回 401 错误
• 文件不存在时返回 404 错误
• 参数错误时返回 400 错误

注意事项

• 需要权限：system:file:query
• fileId 必须是有效的文件 ID
• 只能查询删除标志为 0 的文件（未删除的文件）

相关接口

• 查询文件列表 - 查询文件列表
• 修改文件 - 修改文件信息
• 删除文件 - 删除文件

实现细节

• 使用 ISysFileInfoService.selectSysFileInfoByFileId() 查询文件信息
• 使用 @PreAuthorize 注解进行权限控制
• 继承 BaseController 获取基础功能
• 使用 success() 方法封装成功响应