个人草稿变更列表
接口说明
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代码示例。
调试
授权信息
请求语法
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 |
相对当前在线的真实发布效果(草稿保存后在线图谱可能已变化,操作意图按在线现状修正) 枚举值:
|
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"
}
]
}