API 参考 / blueprints

读取当前 OnePage 版本(编辑器入口)

GET /api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/onepage · getCurrentOnePage

读取草案当前 one_page_version_id 指向的版本(编辑器入口)。仅 active Org Admin 可读; 普通成员 / 错 org 404。已确认版本仍可读(永久只读查看,按原快照与证据)。 PAT 不可调用本端点。

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

参数

orgId(必填)
string
draftId(必填)
string

响应字段 · 200

id(必填)
string
draftId(必填)
string
orgId(必填)
string
directionId(必填)
string
directionSetVersion
string
surveyVersionId
string
marketSnapshotId
string
promptVersion
string
modelId
string
blocks(必填)
OnePageBlock[]
blocks[].id(必填)
string
blocks[].title(必填)
string
blocks[].content(必填)
string
blocks[].locked(必填)
boolean
blocks[].source(必填)
enum —— 区块来源标记(区分 AI 初始 / AI 重生成 / 用户修改)。上屏三态标记来源(设计稿 g10:AI 生成 / 已锁定 / 用户已编辑)。不用颜色作唯一区分。;取值:ai_initial / ai_regen / user_edit
blocks[].evidenceRefs(必填)
string[]
status(必填)
enum —— OnePage 版本状态。状态机:editing(块可 locked)→ confirmed(永久只读)→ superseded(重分析产 v{n+1},不覆盖创建时版本)。;取值:editing / confirmed / superseded
revision(必填)
integer
version(必填)
integer
createdBy
string
createdAt(必填)
string
updatedAt(必填)
string
confirmedAt
string

错误

请求示例(curl)

curl -X GET "https://workflow.games/api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/onepage" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "id": "018f3c2e-0000-7000-8000-000000000000",
  "draftId": "018f3c2e-0000-7000-8000-000000000000",
  "orgId": "018f3c2e-0000-7000-8000-000000000000",
  "directionId": "018f3c2e-0000-7000-8000-000000000000",
  "blocks": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "title": "示例标题",
      "content": "示例文本",
      "locked": true,
      "source": "ai_initial",
      "evidenceRefs": [
        "示例文本"
      ]
    }
  ],
  "status": "editing",
  "revision": 1,
  "version": 1,
  "createdAt": "示例文本",
  "updatedAt": "2026-08-01"
}

合同真值:OpenAPI 3.1(0.1.0)。

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

Workflow 正在加载…