API 参考 / admin

写附件对象存储配置（平台超管）

PUT /api/v1/admin/settings/attachment-storage · adminUpdateAttachmentStorageSettings

覆盖附件文件本体的 S3 兼容对象存储配置（endpoint / region / bucket / 凭证 / path-style / key 前缀）。 secretAccessKey 留空表示保留已存密钥（不覆盖）；密钥明文存控制面库、GET 永不回显。 保存前会用候选配置做一次真实往返自检（PutObject → GetObject → 比对 → DeleteObject）， 自检不通过直接 422 拒绝保存——存储配错会让上传的文件静默丢失，代价不允许推迟到第一次上传才暴露。 bucket 必须已存在（服务端不建 bucket）。全部字段留空 = 停用对象存储，跳过自检直接保存。 保存成功后运行时立即换用新配置，无需重启。写审计 platform.settings.update（metadata 不含任何凭证）。 要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

请求体

endpoint（必填）
string
region（必填）
string
bucket（必填）
string
accessKeyId（必填）
string
secretAccessKey
string
usePathStyle（必填）
boolean
keyPrefix（必填）
string

响应字段 · 200

endpoint（必填）
string
region（必填）
string
bucket（必填）
string
accessKeyId（必填）
string
usePathStyle（必填）
boolean
keyPrefix（必填）
string
secretAccessKeyConfigured（必填）
boolean
configured（必填）
boolean

错误

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/attachment-storage" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"endpoint":"示例文本","region":"示例文本","bucket":"示例文本","accessKeyId":"018f3c2e-0000-7000-8000-000000000000","usePathStyle":true,"keyPrefix":"示例文本"}'

响应示例

HTTP/1.1 200
{
  "endpoint": "示例文本",
  "region": "示例文本",
  "bucket": "示例文本",
  "accessKeyId": "018f3c2e-0000-7000-8000-000000000000",
  "usePathStyle": true,
  "keyPrefix": "示例文本",
  "secretAccessKeyConfigured": true,
  "configured": true
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…