批量保存个人语义草稿
接口说明
OpenAPI 批量保存个人语义草稿（仅个人 Token）。
业务编排：
1. 草稿域身份校验（仅个人 Token；部署/系统级 Token 被拒绝）
与语义管理权限校验
2. saveMode 分派：FULL_YAML（默认）为整图 full YAML 差量保存，
含失效草稿丢弃与 order 集合写权限校验；PARTIAL_YAML 为按
draftChangeIds 圈定范围的局部 YAML 保存
3. diff 基准一律由后端读取线上 active（不信任入参 base）
错误码：
- ERR.User.TokenUserOnly: 个人草稿仅支持用户 Token
- ERR.Robject.Global.InvalidParameter: saveMode 非法 / PARTIAL_YAML 未提供 draftChangeIds
- ERR.GraphSchema.*: 图谱不存在 / YAML 结构校验失败 / 自建物理表契约不合法
- ERR.Robject.Global.BusinessStateConflict: 涉及资源正在发布中
- ERR.Robject.Permission.*: order 集合级写权限校验失败
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /openapi/saveGraphDraftBatchDefine HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 id。 |
10000 |
| graphName |
string |
是 |
图谱名称 |
crm_graph |
| yamlEdit |
string |
是 |
按 READ 权限裁剪的 Graph Schema 原始 YAML 文本，保留授权子图内的 $ref |
name: crm_graph |
| saveMode |
string |
否 |
保存模式 |
FULL_YAML |
| draftChangeIds |
array |
否 |
草稿变更 ID 列表 |
[401001, 401002] |
|
integer |
否 |
草稿变更 ID |
401001 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
批量保存语义草稿响应体。 |
||
| code |
string |
状态码。 |
200 |
| message |
string |
状态码描述。 |
ok |
| requestId |
string |
请求追踪 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| graphName |
string |
图谱名称 |
crm_graph |
| saveMode |
string |
保存模式 |
FULL_YAML |
| savedCount |
integer |
保存数量 |
2 |
| items |
array<object> |
MCP 卡片列表。 |
|
|
object |
地点聚类 |
||
| draftChangeId |
integer |
草稿变更唯一 ID（撤销草稿、发布时引用） |
401001 |
| resourceType |
string |
资源类型 |
object |
| elementType |
string |
元素类型，目前仅支持 text。 |
object_type |
| resourceName |
string |
智能体运行时的资源名称 |
customer |
| operationType |
string |
操作类型。 |
UPDATE |
| draftContentHash |
string |
草稿保存时基于的在线内容哈希（草稿起点），64 位 sha256 十六进制 |
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| baseContentHash |
string |
草稿内容本身的哈希，64 位 sha256 十六进制 |
a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e |
| baseSchemaVersion |
string |
草稿基于的 active Schema 版本号 |
v1.0.3 |
| sourceType |
string |
来源类型。 |
BATCH_DEFINE |
| gmtModified |
string |
更新时间(ISO8601) |
2026-09-11T10:30:00+00:00 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "ok",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"graphName": "crm_graph",
"saveMode": "FULL_YAML",
"savedCount": 2,
"items": [
{
"draftChangeId": 401001,
"resourceType": "object",
"elementType": "object_type",
"resourceName": "customer",
"operationType": "UPDATE",
"draftContentHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"baseContentHash": "a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e",
"baseSchemaVersion": "v1.0.3",
"sourceType": "BATCH_DEFINE",
"gmtModified": "2026-09-11T10:30:00+00:00"
}
]
}