API 参考 / admin

写公开演示环境配置（平台超管）

PUT /api/v1/admin/settings/public-demo · adminUpdatePublicDemoSettings

覆盖公开演示环境配置（单 key upsert，attachment_storage 同款范式）：总开关 enabled 与 演示项目 id 列表 projectIds。 这项配置改变的是访问控制，不只是展示：被列入 projectIds 的项目，其项目子域上 白名单内的 GET 端点变为匿名可读（不需要登录），同时该项目上一切非 GET 请求 一律 403——包括带管理员会话与 PAT 的请求。这是环境级不变量，不是权限计算结果。 enabled=false 时列表保留但不生效（便于临时下线演示环境而不丢配置）。 projectIds 里的每个 id 必须是存在的项目，否则 422。写审计 platform.settings.update。 要求平台超管。

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

请求体

enabled（必填）
boolean
projectIds（必填）
string[]

响应字段 · 200

enabled（必填）
boolean
projectIds（必填）
string[]

错误

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/public-demo" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"enabled":true,"projectIds":["018f3c2e-0000-7000-8000-000000000000"]}'

响应示例

HTTP/1.1 200
{
  "enabled": true,
  "projectIds": [
    "018f3c2e-0000-7000-8000-000000000000"
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…