跳转到主要内容
POST
发布文件为产物

限制说明

使用说明

  • 能看到该文件的账户成员都可以发布。若该文件路径已有已发布产物,再次发布会替换该产物,需要对其有 can_edit 权限。
  • 允许的文件类型:HTML/Markdown、图片、PDF、文本/数据/代码文件以及 zip/tar 压缩包(按扩展名判断)。其他类型、超过 16 MiB 的文件、以及已无法取回的文件(runner 离线或文件过期)返回 InvalidParameter。
  • 发布按(来源会话 + 工作区路径)做 upsert:再次发布会以新的 file_id 替换标题和内容,artifact_id 不变,已有的公开快照因此过期,需同步刷新。再次发布已移除的产物会以同一 artifact_id 恢复,且分享处于关闭状态。
  • 新产物的创建者和个人/团队空间取自来源会话(会话所有者及其团队);如需调整,发布后调用 /safari/artifact/gallery/update。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

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

请求体

application/json

把会话中生成的文件发布到产物库。

file_id
string
必填

会话中生成的文件 ID(pf_ 前缀),即会话文件卡片上的文件标识。

title
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

发布产物的结果。