下载目录

将指定目录递归打包为 zip 文件下载。

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

请求头

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

请求参数（Query）

参数名	类型	必填	说明
user_id	string	是	业务方用户 ID，用于确定所属工作空间
path	string	否	目录路径，默认 /（下载整个工作空间）

请求示例（curl）：

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

响应说明

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

响应头	说明
Content-Type	application/zip
Content-Disposition	attachment; filename=<目录名>.zip

失败时返回标准 JSON 响应：

{
  "code": 200,
  "data": null,
  "message": "目录不存在",
  "trace_id": "abc123"
}

WARNING

目录内文件较多或包含大文件时，打包和下载耗时可能较长。建议对大文件使用下载文件接口单独下载。