下载附件接口

接口

HttpGet：api/FrontEnd/DownloadFile/{fileId}

根据附件 ID 下载文件。接口要求登录，平台文件服务负责文件存在性和访问权限校验。

请求参数

请求头

参数名	类型	是否必填	说明
Authorization	string	是	登录令牌，格式为 Bearer {token}。
UserId	string	是	当前登录账号编码，必须与令牌用户一致。
TnCode	string	是	租户编码。

路径参数

参数名	类型	是否必填	说明
fileId	string	是	上传接口返回的文件 ID。

请求示例

GET /baseUrl/api/FrontEnd/DownloadFile/file-3d731bf0 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9...
UserId: administrator
TnCode: 00000000

返回结果

成功时直接返回文件二进制流，不使用 JSON 包装。

响应头	说明
Content-Type	文件实际 MIME 类型；未识别时为 application/octet-stream。
Content-Disposition	attachment 下载文件名，使用 UTF-8 编码。

失败时返回 HTTP 错误：

状态码	说明
400	文件 ID 为空。
401	登录令牌无效或数据令牌校验失败。
404	文件不存在。
500	文件读取失败。

调用说明

• 文件 ID 应来自 UploadFile 返回值或表单字段文件描述中的 fileId。
• 客户端不要继续拼接旧的 /api/Form/DownloadFile/{fileId}/{tenantCode} 地址。
• 下载请求仍必须携带当前登录用户令牌，不能因为文件 URL 已知而绕过鉴权。