API 参考 / admin

写官网路线图内容（平台超管）

PUT /api/v1/admin/settings/site-roadmap · adminUpdateSiteRoadmapSettings

覆盖官网 /roadmap 页的全部内容（单 key upsert，support / attachment_storage 同款范式）： 介绍段、最后更新文本、以及按「时间意向桶」组织的分组与条目。 刻意不按季度分组：公开路线图承诺顺序而不承诺日期，季度号一写上去就是日期承诺， 对每周到双周出一个能力的迭代节奏必然被打脸。桶的类型（shipped / now / next / later） 只决定展示样式，桶的名字由运营自己写，因此按双周叫「本期」也成立。 条目状态词表与内部 Requirement.status 七态解耦：内部状态由可配置工作流引擎流转、 随项目配置变化，直接暴露会让公开语义随内部流程漂移，也泄露内部流程细节。 条目 url 若填写必须是 https 绝对 URL（与运维外链 / 鸣谢链接同一套口径）。 保存即时生效（公开端点 getSiteRoadmap 直接读库）。写审计 platform.settings.update。要求平台超管。

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

请求体

intro（必填）
string
updatedOn（必填）
string
buckets（必填）
SiteRoadmapBucket[]
buckets[].kind（必填）
enum；取值：shipped / now / next / later
buckets[].title（必填）
string
buckets[].theme（必填）
string
buckets[].enabled（必填）
boolean
buckets[].items（必填）
SiteRoadmapItem[]
buckets[].items[].title（必填）
string
buckets[].items[].status（必填）
enum；取值：shipped / building / integrating / designing / none
buckets[].items[].url
string
buckets[].items[].enabled（必填）
boolean

响应字段 · 200

intro（必填）
string
updatedOn（必填）
string
buckets（必填）
SiteRoadmapBucket[]
buckets[].kind（必填）
enum；取值：shipped / now / next / later
buckets[].title（必填）
string
buckets[].theme（必填）
string
buckets[].enabled（必填）
boolean
buckets[].items（必填）
SiteRoadmapItem[]
buckets[].items[].title（必填）
string
buckets[].items[].status（必填）
enum；取值：shipped / building / integrating / designing / none
buckets[].items[].url
string
buckets[].items[].enabled（必填）
boolean

错误

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/site-roadmap" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"intro":"示例文本","updatedOn":"2026-08-01","buckets":[{"kind":"shipped","title":"示例标题","theme":"示例文本","enabled":true,"items":[{}]}]}'

响应示例

HTTP/1.1 200
{
  "intro": "示例文本",
  "updatedOn": "2026-08-01",
  "buckets": [
    {
      "kind": "shipped",
      "title": "示例标题",
      "theme": "示例文本",
      "enabled": true,
      "items": [
        {}
      ]
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…