跳转到主要内容
POST
签发文件访问链接

限制说明

使用说明

  • 账户内已发布产物的文件都可签发;其他会话文件需要调用者能访问来源会话(或提供有效的 share_token)。文件不存在和无权访问都返回 ResourceNotFound。
  • 两个链接在 expires_in 秒(300 秒)后过期,需重新签发获取新链接。
  • 返回的是相对链接:拼接 https://api.flashcat.cloud 后通过 GET /safari/artifact/stream 访问,且须以签发时的同一成员身份认证。令牌与账户和该成员绑定,其他人无法使用。

授权

app_key
string
query
必填

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

请求体

application/json

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

file_id
string
必填

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

share_token
string

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

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

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

data
object

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