research 本体节点列表（平台超管）

GET /api/v1/research/ontology/{kind} · getResearchOntology

返回某套本体的节点列表（设计稿 r9）。kind 取 gameplay 玩法 / visual 视觉 / monetization 商业化 / production 生产。每套支持别名、父子、映射置信度、人工覆盖、停用。本体与问卷选项同源（R-00057 schema 选项 code）。口径版本化：每 code 默认返回最新版本。仅平台超管可访问。

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

参数

kind（必填）: string
status: string

响应字段 · 200

items（必填）: ResearchOntologyNodeListItem[]
items[].node（必填）: ResearchOntologyNode
items[].node.id（必填）: string
items[].node.kind（必填）: enum；取值：gameplay / visual / monetization / production
items[].node.code（必填）: string —— 稳定 code（与问卷选项 code 同源）
items[].node.name（必填）: string
items[].node.aliases（必填）: string[] —— 别名数组（来源原生标签映射候选词）
items[].node.parentId: string —— 父节点 id（空 = 根节点）
items[].node.confidence（必填）: number —— 映射置信度 0.0~1.0
items[].node.manualOverride（必填）: boolean —— 是否人工覆盖（不被自动学习覆盖）
items[].node.version（必填）: integer —— 版本号（同 kind+code 可多版本）
items[].node.status（必填）: enum；取值：active / deprecated
items[].node.createdAt（必填）: string
items[].node.updatedAt（必填）: string
items[].isLatest（必填）: boolean

错误

401：Problem 错误响应
403：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/research/ontology/{kind}?status=…" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "node": {
        "id": "018f3c2e-0000-7000-8000-000000000000",
        "kind": "gameplay",
        "code": "示例文本",
        "name": "示例标题",
        "aliases": [],
        "confidence": 1,
        "manualOverride": true,
        "version": 1,
        "status": "active",
        "createdAt": "示例文本",
        "updatedAt": "2026-08-01"
      },
      "isLatest": true
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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