下载文件

下载指定路径的单个文件，直接返回文件二进制流。

• 接口路径：GET /v1/openapi/app/files/download

请求头

参数名	必填	说明
Authorization	是	鉴权凭证，格式 Bearer sk_xxx

请求参数（Query）

参数名	类型	必填	说明
user_id	string	是	业务方用户 ID，用于确定所属工作空间
path	string	是	文件路径

请求示例（curl）：

curl -X GET "https://runtime-api.invalid/v1/openapi/app/files/download?user_id=user123&path=/data/file.csv" \
  -H "Authorization: Bearer sk_xxx" \
  -o file.csv

响应说明

成功时直接返回文件二进制流，响应头如下：

响应头	说明
Content-Type	application/octet-stream
Content-Disposition	attachment; filename=<文件名>

失败时返回标准 JSON 响应：

{
  "code": 200,
  "data": null,
  "message": "文件不存在",
  "trace_id": "abc123"
}

TIP

此接口为直接下载，适用于小文件场景。大文件建议使用分片上传完成后，再通过此接口下载。