ListGraphDraftResources - 查询语义图谱个人草稿变更列表

更新时间:
复制 MD 格式

个人草稿变更列表

接口说明

OpenAPI 查询当前用户在指定图谱下的个人草稿变更列表(仅个人 Token)。

业务编排:
1. 草稿域身份校验(仅个人 Token;部署/系统级 Token 被拒绝)
   与语义查看权限校验
2. 返回当前用户的活动草稿(含在线变化风险);
   权限回收场景下底层会顺带清理无权限草稿(既有行为)

在线风险聚合(riskCode / riskMessage)整体序列化为 risk JSON 文本。

错误码:
- ERR.User.TokenUserOnly: 个人草稿仅支持用户 Token
- ERR.GraphSchema.*: 图谱不存在

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /openapi/listGraphDraftResources HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

tenantId

string

否

租户 ID,公共参数,缺省时使用调用方默认租户。

10000

graphName

string

是

图谱名称

crm_graph

返回参数

名称

类型

描述

示例值

object

个人草稿变更列表响应体。

code

string

状态码。

200

message

string

提示信息。

ok

requestId

string

请求追踪 ID。

019FF406-1B10-0065-A97D-2D1920C2A03D

items

array<object>

MCP 卡片列表。

object

版本信息

draftChangeId

integer

草稿变更唯一 ID(撤销草稿、发布时引用)

401001

resourceType

string

资源类型

element

elementType

string

元素类型,目前仅支持 text。

indicator

resourceName

string

智能体运行时的资源名称

customer_contract_amount

operationType

string

操作类型。

UPDATE

effectiveOperation

string

相对当前在线的真实发布效果(草稿保存后在线图谱可能已变化,操作意图按在线现状修正)

枚举值:

  • DELETE :

    DELETE

  • CREATE :

    CREATE

  • UPDATE :

    UPDATE

UPDATE

hasOnlineChanged

boolean

草稿基线是否过期:草稿保存时的在线内容哈希与当前 active 内容哈希不一致即为 true(发布时提示 ONLINE_CHANGED 风险)

true/false

draftContentHash

string

草稿保存时基于的在线内容哈希(草稿起点),64 位 sha256 十六进制

a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e

baseContentHash

string

草稿内容本身的哈希,64 位 sha256 十六进制

e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

baseSchemaVersion

string

草稿基于的 active Schema 版本号

1.2.0

sourceType

string

技能来源类型。

YAML

editMode

string

编辑模式(当前实现恒为 YAML,与 sourceType 对应)

ADVANCED

risk

string

在线风险聚合 JSON 文本(risk_code / risk_message);无风险时为 null

{"risk_code": "ONLINE_CHANGED", "risk_message": "在线内容已变化"}

gmtCreate

string

创建时间。

2026-09-07T09:00:00+00:00

gmtModified

string

更新时间(ISO8601)

2026-09-08T10:30:00+00:00

示例

正常返回示例

JSON格式

{
  "code": "200",
  "message": "ok",
  "requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
  "items": [
    {
      "draftChangeId": 401001,
      "resourceType": "element",
      "elementType": "indicator",
      "resourceName": "customer_contract_amount",
      "operationType": "UPDATE",
      "effectiveOperation": "UPDATE",
      "hasOnlineChanged": true,
      "draftContentHash": "a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e",
      "baseContentHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "baseSchemaVersion": "1.2.0",
      "sourceType": "YAML",
      "editMode": "ADVANCED",
      "risk": "{\"risk_code\": \"ONLINE_CHANGED\", \"risk_message\": \"在线内容已变化\"}",
      "gmtCreate": "2026-09-07T09:00:00+00:00",
      "gmtModified": "2026-09-08T10:30:00+00:00"
    }
  ]
}

错误码

访问错误中心错误中心查看更多错误码。

变更历史

更多信息,参考变更详情变更详情。