跳转到主要内容
GET
下载或预览文件

限制说明

使用说明

  • 使用 /safari/artifact/sign 返回的完整链接,并以签发时同一成员的 app_key 认证。令牌过期或不属于当前成员时返回 ResourceNotFound。
  • 存放在对象存储中的文件返回 302,跳转到 5 分钟内有效的预签名 URL,请跟随重定向。download 模式下的 CSV 文件,以及存放在 runner 上的文件,直接以 200 返回内容。
  • CSV 文件在 download 模式下会补上 UTF-8 BOM(原本没有时)并设置 Content-Type: text/csv; charset=utf-8,以便表格软件正确打开。
  • 存放在 runner 上的文件,若 runner 已不可用则返回 410 和纯文本提示;需重新运行任务生成文件。
  • 响应携带 Cache-Control: private, no-store。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

查询参数

t
string
必填

由 POST /safari/artifact/sign 签发的令牌。与调用账号及成员绑定,有效期 5 分钟。

mode
enum<string>
默认值:download

download(默认)以附件形式返回文件;preview 以 inline 方式返回供浏览器预览。其他取值按 download 处理。

可用选项:
download,
preview

响应

文件内容。存放在 runner 上的文件和 download 模式下的 CSV 文件直接返回内容。Content-Disposition 按 mode 为 attachment 或 inline。

The response is of type file.