Skip to main content
POST
签发文件访问链接

限制说明

使用说明

  • 两个链接在 expires_in 秒(300 秒)后过期,需重新签发获取新链接。
  • 返回的是相对链接 —— 使用前拼接 https://api.flashcat.cloud,然后以 GET /safari/artifact/stream 访问。
  • 签名令牌与调用账号及 app_key 所属成员身份绑定 —— 链接泄露给其他账号或成员不可用。

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

为文件申请签名下载/预览链接。

file_id
string
必填

要签发的文件 ID(pf_ 前缀)。

share_token
string

可选的会话分享链接令牌。仅当调用者通过会话分享链接(而非账号成员身份)访问文件时需要。

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

短期有效的文件下载/预览签名链接。