API 参考 / admin

写官网鸣谢名单（平台超管）

PUT /api/v1/admin/settings/site-credits · adminUpdateSiteCreditsSettings

覆盖官网首页鸣谢区的全部内容（单 key upsert）：引言 + 分组（标题 + 描述）+ 每组人员 （名字 + 头像图片 URL + 可选主页链接）。 头像与主页链接若填写必须是 https 绝对 URL——它们会被渲染进 https 站点，http 图片会被 浏览器按混合内容拦掉，表现为头像空白且无任何提示（B-00324 同款成因）。 鸣谢的是具体的人，名单会被公开展示：录入前请确认当事人同意具名。 保存即时生效（公开端点 getSiteContent 直接读库）。写审计 platform.settings.update。要求平台超管。

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

请求体

intro（必填）
string
groups（必填）
SiteCreditGroup[]
groups[].title（必填）
string
groups[].description（必填）
string
groups[].enabled（必填）
boolean
groups[].people（必填）
SiteCreditPerson[]
groups[].people[].name（必填）
string
groups[].people[].avatarUrl
string
groups[].people[].url
string
groups[].people[].enabled（必填）
boolean

响应字段 · 200

intro（必填）
string
groups（必填）
SiteCreditGroup[]
groups[].title（必填）
string
groups[].description（必填）
string
groups[].enabled（必填）
boolean
groups[].people（必填）
SiteCreditPerson[]
groups[].people[].name（必填）
string
groups[].people[].avatarUrl
string
groups[].people[].url
string
groups[].people[].enabled（必填）
boolean

错误

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/site-credits" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"intro":"示例文本","groups":[{"title":"示例标题","description":"一段描述文字","enabled":true,"people":[{}]}]}'

响应示例

HTTP/1.1 200
{
  "intro": "示例文本",
  "groups": [
    {
      "title": "示例标题",
      "description": "一段描述文字",
      "enabled": true,
      "people": [
        {}
      ]
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…