fix(api-contracts): ID 类型从 uuid string 对齐为 integer int64

与 Yudao Cloud BIGINT 自增 ID 约定对齐,所有 schema 的 id 字段:
- type: string, format: uuid → type: integer, format: int64
This commit is contained in:
zizi 2026-05-24 18:41:13 +08:00
parent 3f0e6aff1f
commit e03f9f3954
4 changed files with 710 additions and 710 deletions

View File

@ -292,8 +292,8 @@ paths:
type: object
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
'400':
$ref: '../openapi-base.yaml#/components/responses/BadRequest'
@ -317,8 +317,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
description: 目标 Agent ID,必须为 system scope。
requestBody:
required: true
@ -369,8 +369,8 @@ paths:
type: object
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
version:
type: integer
'403':
@ -439,8 +439,8 @@ paths:
required: [commandId, reason, agentId, toolType, scope, budget, outboundPolicy]
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
description: 目标智能体 ID
toolType:
type: string
@ -471,8 +471,8 @@ paths:
type: object
properties:
grantId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [approved, revoked]
@ -689,11 +689,11 @@ paths:
type: object
properties:
runId:
type: string
format: uuid
type: integer
format: int64
jobId:
type: string
format: uuid
type: integer
format: int64
'400':
$ref: '../openapi-base.yaml#/components/responses/BadRequest'
@ -714,8 +714,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 评估运行详情
@ -799,8 +799,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 任务详情
@ -833,8 +833,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
content:
application/json:
@ -858,8 +858,8 @@ paths:
type: object
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [queued, running]
@ -883,8 +883,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
content:
application/json:
@ -911,8 +911,8 @@ paths:
type: object
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [cancelled]
@ -984,8 +984,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 来源事件详情
@ -1018,8 +1018,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
content:
application/json:
@ -1046,8 +1046,8 @@ paths:
type: object
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
@ -1145,11 +1145,11 @@ paths:
type: object
properties:
taskId:
type: string
format: uuid
type: integer
format: int64
jobId:
type: string
format: uuid
type: integer
format: int64
pollUrl:
type: string
description: 轮询地址
@ -1179,8 +1179,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: AI 任务详情
@ -1214,8 +1214,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: SSE 事件流
@ -1250,8 +1250,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: status
in: query
schema:
@ -1261,8 +1261,8 @@ paths:
- name: blockId
in: query
schema:
type: string
format: uuid
type: integer
format: int64
description: 按 Block 筛选
responses:
'200':
@ -1298,8 +1298,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 候选详情(含生成内容 diff)
@ -1332,8 +1332,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
content:
application/json:
@ -1450,8 +1450,8 @@ paths:
type: object
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
'400':
$ref: '../openapi-base.yaml#/components/responses/BadRequest'
@ -1472,8 +1472,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1511,8 +1511,8 @@ paths:
type: object
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
version:
type: integer
@ -1535,8 +1535,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1575,8 +1575,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 作品槽位列表
@ -1611,8 +1611,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: slotKey
in: path
required: true
@ -1631,8 +1631,8 @@ paths:
type: string
description: 幂等键
sourceAgentId:
type: string
format: uuid
type: integer
format: int64
description: 来源智能体 ID
sourceAgentVersion:
type: integer
@ -1680,8 +1680,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: slotKey
in: path
required: true
@ -1703,8 +1703,8 @@ paths:
type: string
description: 预检接口返回的绑定凭证,必须由 AI owner 原子消费
sourceAgentId:
type: string
format: uuid
type: integer
format: int64
description: 绑定来源智能体 ID
sourceAgentVersion:
type: integer
@ -1755,8 +1755,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 用户可见任务详情
@ -1789,8 +1789,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
content:
application/json:
@ -1868,8 +1868,8 @@ paths:
type: string
description: 来源对象类型
sourceId:
type: string
format: uuid
type: integer
format: int64
description: 来源对象 ID
sourceRevision:
type: integer
@ -1883,8 +1883,8 @@ paths:
enum: [content, knowledge, ai, market, account]
description: 目标 owner
targetId:
type: string
format: uuid
type: integer
format: int64
description: 目标对象 ID
authorizationSnapshotId:
type: string
@ -1903,8 +1903,8 @@ paths:
type: object
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
pollUrl:
type: string
@ -1959,8 +1959,8 @@ components:
required: [agentId, name, scope, status, updatedAt]
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
description:
@ -1986,11 +1986,11 @@ components:
required: [grantId, agentId, toolType, scope, budget, outboundPolicy, status, createdAt]
properties:
grantId:
type: string
format: uuid
type: integer
format: int64
agentId:
type: string
format: uuid
type: integer
format: int64
agentName:
type: string
toolType:
@ -2093,8 +2093,8 @@ components:
required: [taskId, taskType, status, createdAt]
properties:
taskId:
type: string
format: uuid
type: integer
format: int64
taskType:
type: string
enum: [generation, continuation, expansion, polish, detection, planning]
@ -2106,12 +2106,12 @@ components:
type: string
description: 任务所属用户
workId:
type: string
format: uuid
type: integer
format: int64
description: 关联作品 ID
agentId:
type: string
format: uuid
type: integer
format: int64
description: 使用的智能体 ID
createdAt:
type: string
@ -2147,8 +2147,8 @@ components:
required: [runId, policyKey, status, createdAt]
properties:
runId:
type: string
format: uuid
type: integer
format: int64
policyKey:
type: string
policyVersion:
@ -2200,8 +2200,8 @@ components:
required: [jobId, type, status, owner, createdAt]
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
type:
type: string
description: 任务类型(如 knowledge_extraction, export, evaluation 等)
@ -2229,8 +2229,8 @@ components:
required: [jobId, type, status, owner, createdAt]
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
type:
type: string
status:
@ -2283,14 +2283,14 @@ components:
required: [eventId, sourceType, sourceId, sourceStatus, actionPolicy, createdAt]
properties:
eventId:
type: string
format: uuid
type: integer
format: int64
sourceType:
type: string
description: 来源对象类型
sourceId:
type: string
format: uuid
type: integer
format: int64
description: 来源对象 ID
sourceStatus:
type: string
@ -2310,13 +2310,13 @@ components:
required: [eventId, sourceType, sourceId, sourceStatus, actionPolicy, reasonAttributions, createdAt]
properties:
eventId:
type: string
format: uuid
type: integer
format: int64
sourceType:
type: string
sourceId:
type: string
format: uuid
type: integer
format: int64
sourceStatus:
type: string
enum: [active, stale, revoked, recalled, delisted, blocked, owner_missing, unauthorized]
@ -2343,8 +2343,8 @@ components:
type: string
description: 传播状态
jobId:
type: string
format: uuid
type: integer
format: int64
description: 关联的传播任务 ID
nextActions:
type: array
@ -2359,8 +2359,8 @@ components:
required: [eventId, eventType, operator, createdAt]
properties:
eventId:
type: string
format: uuid
type: integer
format: int64
eventType:
type: string
description: 审计事件类型
@ -2413,8 +2413,8 @@ components:
enum: [work, chapter, block]
description: 引用类型
refId:
type: string
format: uuid
type: integer
format: int64
description: 引用对象 ID;chapter/block 必须属于 workId 指向的作品。
expectedRevision:
type: integer
@ -2426,8 +2426,8 @@ components:
description: 可验证的智能体覆盖引用;服务端仍必须通过 Agent BC 和 Security facade 校验。
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
description: 覆盖使用的智能体 ID
agentVersion:
type: integer
@ -2449,16 +2449,16 @@ components:
intent:
$ref: '#/components/schemas/AiTaskIntent'
workId:
type: string
format: uuid
type: integer
format: int64
description: 目标作品 ID;服务端以此作为上下文和权限边界。
blockId:
type: string
format: uuid
type: integer
format: int64
description: 目标 Block 引用(正文生成/续写等场景必填);服务端校验其归属 workId。
chapterId:
type: string
format: uuid
type: integer
format: int64
description: 目标章节引用;服务端校验其归属 workId。
agentSlotKey:
type: string
@ -2481,28 +2481,28 @@ components:
required: [taskId, taskType, agentId, status, createdAt]
properties:
taskId:
type: string
format: uuid
type: integer
format: int64
taskType:
type: string
enum: [generation, continuation, expansion, polish, detection, planning]
agentId:
type: string
format: uuid
type: integer
format: int64
agentName:
type: string
workId:
type: string
format: uuid
type: integer
format: int64
blockId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [queued, running, streaming, completed, failed, cancelled]
suggestionId:
type: string
format: uuid
type: integer
format: int64
description: 任务完成后关联的候选 ID
sourceRevision:
type: integer
@ -2533,18 +2533,18 @@ components:
required: [suggestionId, taskType, status, createdAt]
properties:
suggestionId:
type: string
format: uuid
type: integer
format: int64
taskId:
type: string
format: uuid
type: integer
format: int64
description: 关联的 AI 任务 ID
blockId:
type: string
format: uuid
type: integer
format: int64
agentId:
type: string
format: uuid
type: integer
format: int64
agentName:
type: string
taskType:
@ -2571,17 +2571,17 @@ components:
required: [suggestionId, taskId, status, sourceRevision, createdAt]
properties:
suggestionId:
type: string
format: uuid
type: integer
format: int64
taskId:
type: string
format: uuid
type: integer
format: int64
blockId:
type: string
format: uuid
type: integer
format: int64
agentId:
type: string
format: uuid
type: integer
format: int64
agentName:
type: string
taskType:
@ -2633,8 +2633,8 @@ components:
required: [agentId, name, scope, status, updatedAt]
properties:
agentId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
description:
@ -2657,8 +2657,8 @@ components:
required: [commandId, input]
properties:
workId:
type: string
format: uuid
type: integer
format: int64
description: 可选,关联作品上下文;不传时使用沙箱上下文
contextScope:
type: string
@ -2705,12 +2705,12 @@ components:
enum: [preview_only, shadow_candidate]
description: 输出实际落点
suggestionId:
type: string
format: uuid
type: integer
format: int64
description: outputDestination=shadow_candidate 时关联的候选 ID
jobId:
type: string
format: uuid
type: integer
format: int64
description: 若异步执行,返回任务 ID 供轮询
AgentSlotSummary:
@ -2730,8 +2730,8 @@ components:
type: boolean
description: 是否为保护节点(保护节点不可替换)
boundAgentId:
type: string
format: uuid
type: integer
format: int64
description: 已绑定的智能体 ID
boundAgentName:
type: string
@ -2755,8 +2755,8 @@ components:
required: [jobId, type, status, createdAt]
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
type:
type: string
status:
@ -2786,8 +2786,8 @@ components:
type: string
description: 来源对象类型
sourceId:
type: string
format: uuid
type: integer
format: int64
description: 来源对象 ID
purpose:
type: string
@ -2798,8 +2798,8 @@ components:
enum: [content, knowledge, ai, market, account]
description: 目标 owner
targetId:
type: string
format: uuid
type: integer
format: int64
description: 目标对象 ID
sourceRevision:
type: integer
@ -2865,6 +2865,6 @@ components:
type: string
description: 当前授权快照 ID
jobId:
type: string
format: uuid
type: integer
format: int64
description: 可选,关联的异步任务 ID

View File

@ -113,8 +113,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 作品详情
@ -145,8 +145,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -193,8 +193,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 删除成功
@ -215,8 +215,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 章节列表(按 sortOrder 排序)
@ -249,8 +249,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -299,14 +299,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 章节详情(含 Block 列表)
@ -338,14 +338,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -374,14 +374,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -412,14 +412,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -451,14 +451,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: Block 列表
@ -492,14 +492,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: chapterId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -539,14 +539,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: Block 详情
@ -578,14 +578,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -627,14 +627,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -665,14 +665,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -703,14 +703,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
description: 与下一个 Block 合并
requestBody:
required: true
@ -742,8 +742,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -758,8 +758,8 @@ paths:
includeChapters:
type: array
items:
type: string
format: uuid
type: integer
format: int64
description: 指定导出章节,空数组表示导出全部
responses:
'200':
@ -850,8 +850,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 作品元信息、章节摘要、异常摘要
@ -885,8 +885,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 章节列表
@ -928,8 +928,8 @@ paths:
- name: workId
in: query
schema:
type: string
format: uuid
type: integer
format: int64
description: 按作品过滤
responses:
'200':
@ -977,8 +977,8 @@ paths:
- name: workId
in: query
schema:
type: string
format: uuid
type: integer
format: int64
description: 按作品过滤
responses:
'200':
@ -1022,8 +1022,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1067,14 +1067,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: Block 来源归因信息
@ -1107,14 +1107,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: blockId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1157,8 +1157,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 作品维度 MetaSchema 投影列表
@ -1196,8 +1196,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: projectionKey
in: path
required: true
@ -1240,8 +1240,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1284,8 +1284,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 作品规划结构
@ -1321,8 +1321,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: sectionKey
in: path
required: true
@ -1371,8 +1371,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1420,8 +1420,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: status
in: query
schema:
@ -1468,14 +1468,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: candidateId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 规划候选详情
@ -1513,14 +1513,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: candidateId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1560,14 +1560,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: candidateId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1604,8 +1604,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1654,14 +1654,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: jobId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 文风检查结果
@ -1699,8 +1699,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1739,8 +1739,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 导入任务详情
@ -1779,8 +1779,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1820,8 +1820,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: AI 解析任务详情
@ -1855,8 +1855,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1912,8 +1912,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 章节解析结果列表
@ -1952,8 +1952,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2003,8 +2003,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2042,8 +2042,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2085,8 +2085,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2125,8 +2125,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 导出任务详情
@ -2201,8 +2201,8 @@ components:
required: [id, title, status, createdAt, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
title:
type: string
description:
@ -2233,8 +2233,8 @@ components:
required: [id, title, status, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
title:
type: string
genre:
@ -2255,11 +2255,11 @@ components:
required: [id, workId, title, sortOrder, status, createdAt, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
title:
type: string
sortOrder:
@ -2293,14 +2293,14 @@ components:
required: [id, workId, chapterId, blockType, content, sortOrder, revision, createdAt, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
chapterId:
type: string
format: uuid
type: integer
format: int64
blockType:
type: string
enum: [scene, section, note]
@ -2496,8 +2496,8 @@ components:
type: integer
description: 源 Block 当前 revision(乐观锁)
targetBlockId:
type: string
format: uuid
type: integer
format: int64
description: 目标相邻 Block ID;不传时默认与下一个 Block 合并
sourceSnapshot:
$ref: '#/components/schemas/ContentSourceSnapshot'
@ -2510,8 +2510,8 @@ components:
required: [suggestionId, commandId, expectedBlockRevision, decisionType, mergeMode, sourceSnapshot]
properties:
suggestionId:
type: string
format: uuid
type: integer
format: int64
description: AI Orchestration owner 产生的候选 ID
commandId:
type: string
@ -2551,11 +2551,11 @@ components:
required: [blockId, suggestionId, newRevision, decisionType]
properties:
blockId:
type: string
format: uuid
type: integer
format: int64
suggestionId:
type: string
format: uuid
type: integer
format: int64
newRevision:
type: integer
description: Block 保存成功后的新 revision
@ -2572,8 +2572,8 @@ components:
required: [id, title, status, ownerId, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
title:
type: string
genre:
@ -2620,8 +2620,8 @@ components:
required: [id, title, status, ownerId, createdAt, updatedAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
title:
type: string
description:
@ -2689,8 +2689,8 @@ components:
required: [id, title, sortOrder, status]
properties:
id:
type: string
format: uuid
type: integer
format: int64
title:
type: string
sortOrder:
@ -2741,8 +2741,8 @@ components:
targetIds:
type: array
items:
type: string
format: uuid
type: integer
format: int64
description: 指定治理的章节或 Block ID(粒度非 work 时必填)
expectedVersion:
type: integer
@ -2774,11 +2774,11 @@ components:
required: [id, workId, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
workTitle:
type: string
fileName:
@ -2807,11 +2807,11 @@ components:
required: [id, workId, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
workTitle:
type: string
format:
@ -2836,8 +2836,8 @@ components:
required: [blockId, revision]
properties:
blockId:
type: string
format: uuid
type: integer
format: int64
revision:
type: integer
description: Block 当前 revision 号
@ -3081,8 +3081,8 @@ components:
required: [workId, revision]
properties:
workId:
type: string
format: uuid
type: integer
format: int64
revision:
type: integer
description: 规划数据 revision
@ -3213,8 +3213,8 @@ components:
required: [id, sectionKey, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
sectionKey:
type: string
taskType:
@ -3241,8 +3241,8 @@ components:
required: [id, sectionKey, status, content, revision, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
sectionKey:
type: string
taskType:
@ -3379,8 +3379,8 @@ components:
targetIds:
type: array
items:
type: string
format: uuid
type: integer
format: int64
description: 指定检查的章节或 Block ID(checkScope 非 full_work 时必填)
styleRules:
type: object
@ -3401,8 +3401,8 @@ components:
required: [jobId, status]
properties:
jobId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [queued, processing, completed, failed]
@ -3504,11 +3504,11 @@ components:
required: [id, workId, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
fileName:
type: string
fileSize:
@ -3566,8 +3566,8 @@ components:
type: string
description: 幂等键
importTaskId:
type: string
format: uuid
type: integer
format: int64
description: 关联的导入任务 ID
parseConfig:
type: object
@ -3599,14 +3599,14 @@ components:
required: [id, workId, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
importTaskId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [queued, processing, completed, failed]
@ -3657,11 +3657,11 @@ components:
required: [id, jobId, title, status, revision]
properties:
id:
type: string
format: uuid
type: integer
format: int64
jobId:
type: string
format: uuid
type: integer
format: int64
title:
type: string
description: AI 检测到的章节标题
@ -3738,8 +3738,8 @@ components:
type: array
description: 待确认的 chapter parse result ID 列表
items:
type: string
format: uuid
type: integer
format: int64
BatchConfirmChaptersResult:
type: object
@ -3749,14 +3749,14 @@ components:
type: array
description: 成功确认的章节 result ID 列表
items:
type: string
format: uuid
type: integer
format: int64
createdDraftIds:
type: array
description: 生成的知识草稿 ID 列表
items:
type: string
format: uuid
type: integer
format: int64
failedChapters:
type: array
description: 失败章节列表
@ -3764,8 +3764,8 @@ components:
type: object
properties:
resultId:
type: string
format: uuid
type: integer
format: int64
errorCode:
type: string
errorMessage:
@ -3777,8 +3777,8 @@ components:
type: object
properties:
resultId:
type: string
format: uuid
type: integer
format: int64
reason:
type: string
partialFailure:
@ -3801,8 +3801,8 @@ components:
type: array
description: 指定导出章节 ID,空数组表示导出全部
items:
type: string
format: uuid
type: integer
format: int64
includeMetadata:
type: boolean
default: true
@ -3828,11 +3828,11 @@ components:
required: [id, workId, format, status, createdAt]
properties:
id:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
format:
type: string
enum: [txt, epub, docx]

View File

@ -156,8 +156,8 @@ paths:
type: object
properties:
kbId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [draft]
@ -182,8 +182,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 全局知识库详情
@ -198,8 +198,8 @@ paths:
type: object
properties:
kbId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
description:
@ -252,8 +252,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -314,8 +314,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- $ref: '../openapi-base.yaml#/components/parameters/pageNo'
- $ref: '../openapi-base.yaml#/components/parameters/pageSize'
- name: processingStatus
@ -369,8 +369,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -413,8 +413,8 @@ paths:
type: object
properties:
documentId:
type: string
format: uuid
type: integer
format: int64
scanTaskId:
type: string
processingStatus:
@ -437,14 +437,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 资料详情
@ -513,14 +513,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -569,14 +569,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -629,8 +629,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 版本列表
@ -690,8 +690,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: version
in: path
required: true
@ -748,8 +748,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 授权策略列表
@ -816,8 +816,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -894,14 +894,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: draftId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -952,8 +952,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -999,8 +999,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1051,8 +1051,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1118,8 +1118,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1176,8 +1176,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- $ref: '../openapi-base.yaml#/components/parameters/pageNo'
- $ref: '../openapi-base.yaml#/components/parameters/pageSize'
- name: status
@ -1230,8 +1230,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1446,8 +1446,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: status
in: query
schema:
@ -1474,8 +1474,8 @@ paths:
type: object
properties:
entityId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
type:
@ -1512,8 +1512,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 实体详情
@ -1528,8 +1528,8 @@ paths:
type: object
properties:
entityId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
type:
@ -1592,8 +1592,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1649,8 +1649,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 关系列表
@ -1697,8 +1697,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
description: 源实体
requestBody:
required: true
@ -1709,8 +1709,8 @@ paths:
required: [targetEntityId, relationType, commandId]
properties:
targetEntityId:
type: string
format: uuid
type: integer
format: int64
relationType:
type: string
example: "knows"
@ -1751,8 +1751,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: depth
in: query
schema:
@ -1923,8 +1923,8 @@ paths:
type: object
properties:
kbId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [draft]
@ -1945,8 +1945,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 知识库详情
@ -2034,8 +2034,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2084,8 +2084,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2141,8 +2141,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2192,8 +2192,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2240,8 +2240,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- $ref: '../openapi-base.yaml#/components/parameters/pageNo'
- $ref: '../openapi-base.yaml#/components/parameters/pageSize'
- name: processingStatus
@ -2308,8 +2308,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2352,8 +2352,8 @@ paths:
type: object
properties:
documentId:
type: string
format: uuid
type: integer
format: int64
scanTaskId:
type: string
processingStatus:
@ -2375,14 +2375,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 资料版本列表
@ -2425,14 +2425,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2485,14 +2485,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: documentId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2541,14 +2541,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: taskId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 处理任务详情
@ -2610,8 +2610,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2671,8 +2671,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2741,8 +2741,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2801,8 +2801,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2866,8 +2866,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -2991,8 +2991,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3039,8 +3039,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3086,8 +3086,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3136,8 +3136,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: entityType
in: query
schema:
@ -3223,8 +3223,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: status
in: query
schema:
@ -3251,8 +3251,8 @@ paths:
type: object
properties:
draftId:
type: string
format: uuid
type: integer
format: int64
entityType:
type: string
name:
@ -3291,8 +3291,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3374,8 +3374,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3425,8 +3425,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3481,8 +3481,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3595,8 +3595,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -3661,14 +3661,14 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
- name: bindingId
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:

View File

@ -50,8 +50,8 @@ paths:
in: query
description: 分类 ID 筛选
schema:
type: string
format: uuid
type: integer
format: int64
- name: keyword
in: query
description: 搜索关键词
@ -146,14 +146,14 @@ paths:
in: query
description: 参考资产 ID(用于"相似资产"推荐)
schema:
type: string
format: uuid
type: integer
format: int64
- name: workId
in: query
description: 关联作品 ID(用于跨空间场景下按作品槽位推荐)
schema:
type: string
format: uuid
type: integer
format: int64
- name: limit
in: query
description: 返回数量上限
@ -281,8 +281,8 @@ paths:
required: [commandId]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键,前端生成 UUID
licenseType:
type: string
@ -333,12 +333,12 @@ paths:
required: [commandId]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键,前端生成 UUID
versionId:
type: string
format: uuid
type: integer
format: int64
description: 指定安装的版本 ID(不指定则安装当前版本)
pinVersion:
type: boolean
@ -397,12 +397,12 @@ paths:
enum: [slot_bind, bind, asset_use]
description: 目标动作
targetWorkId:
type: string
format: uuid
type: integer
format: int64
description: 目标作品 ID
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
responses:
'200':
@ -443,8 +443,8 @@ paths:
required: [assetId, targetOwner, targetAction, returnUrl, commandId]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
description: 来源资产 ID
targetOwner:
type: string
@ -455,20 +455,20 @@ paths:
enum: [slot_bind, bind, asset_use, governance_handle]
description: 目标动作
targetWorkId:
type: string
format: uuid
type: integer
format: int64
description: 目标作品 ID
authorizationSummaryId:
type: string
format: uuid
type: integer
format: int64
description: 来源侧授权摘要 ID(来自 bind-precheck),不是目标 owner 预检 ID
returnUrl:
type: string
format: uri
description: 完成后返回市场的 URL
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
responses:
'200':
@ -547,8 +547,8 @@ paths:
required: [commandId, expectedStatus, reason]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
@ -623,8 +623,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 发布检查完成
@ -661,16 +661,16 @@ paths:
required: [draftId, marketPublishCheckId, commandId]
properties:
draftId:
type: string
format: uuid
type: integer
format: int64
description: 发布草稿 ID
marketPublishCheckId:
type: string
format: uuid
type: integer
format: int64
description: 发布检查结果 ID(消费检查快照)
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
responses:
'200':
@ -705,8 +705,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -716,8 +716,8 @@ paths:
required: [commandId, expectedStatus, reason]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
@ -841,8 +841,8 @@ paths:
required: [assetId, appealType, reason, commandId]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
description: 申诉对象资产 ID
appealType:
type: string
@ -858,8 +858,8 @@ paths:
type: string
description: 证据材料标识列表
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
responses:
'200':
@ -894,8 +894,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -917,8 +917,8 @@ paths:
type: boolean
description: 是否已确认隐私处理
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
responses:
'200':
@ -948,8 +948,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -962,8 +962,8 @@ paths:
type: string
description: 撤回原因
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
@ -1021,8 +1021,8 @@ paths:
in: query
description: 发布者 ID
schema:
type: string
format: uuid
type: integer
format: int64
- name: keyword
in: query
description: 资产名称搜索
@ -1106,8 +1106,8 @@ paths:
required: [commandId, actionType]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
actionType:
type: string
@ -1156,16 +1156,16 @@ paths:
required: [commandId, expectedStatus, impactPreviewId, reason, scope]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
enum: [listed]
description: 期望当前上架状态,避免盲下架
impactPreviewId:
type: string
format: uuid
type: integer
format: int64
description: 关联的治理影响预览 ID
reason:
type: string
@ -1212,16 +1212,16 @@ paths:
required: [commandId, expectedStatus, impactPreviewId, reason, basis, scope]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
enum: [listed, delisted]
description: 期望当前治理状态,避免盲召回
impactPreviewId:
type: string
format: uuid
type: integer
format: int64
description: 关联的治理影响预览 ID
reason:
type: string
@ -1292,8 +1292,8 @@ paths:
in: query
description: 发布者 ID
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 发布申请分页列表
@ -1334,8 +1334,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1345,16 +1345,16 @@ paths:
required: [commandId, expectedStatus, validationResultId, note]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
enum: [pending, reviewing, needs_supplement]
description: 期望当前审核状态,避免盲通过
validationResultId:
type: string
format: uuid
type: integer
format: int64
description: 审核校验结果引用 ID
note:
type: string
@ -1395,8 +1395,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1406,16 +1406,16 @@ paths:
required: [commandId, expectedStatus, validationResultId, reason]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
enum: [pending, reviewing, needs_supplement]
description: 期望当前审核状态,避免盲驳回
validationResultId:
type: string
format: uuid
type: integer
format: int64
description: 审核校验结果引用 ID
reason:
type: string
@ -1482,14 +1482,14 @@ paths:
in: query
description: 申诉人 ID
schema:
type: string
format: uuid
type: integer
format: int64
- name: assetId
in: query
description: 关联资产 ID
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 申诉分页列表
@ -1530,8 +1530,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
responses:
'200':
description: 申诉详情
@ -1567,8 +1567,8 @@ paths:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
requestBody:
required: true
content:
@ -1578,8 +1578,8 @@ paths:
required: [commandId, expectedStatus, impactPreviewId, resolution, reason]
properties:
commandId:
type: string
format: uuid
type: integer
format: int64
description: 幂等键
expectedStatus:
type: string
@ -1599,8 +1599,8 @@ paths:
type: string
description: 处理证据标签
impactPreviewId:
type: string
format: uuid
type: integer
format: int64
description: 恢复时的关联影响预览 ID
requireSupplement:
type: boolean
@ -1647,8 +1647,8 @@ components:
in: path
required: true
schema:
type: string
format: uuid
type: integer
format: int64
description: 市场资产 ID
schemas:
@ -1662,8 +1662,8 @@ components:
required: [assetId, name, assetType, publisherName, version, listingStatus]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
maxLength: 200
@ -1732,8 +1732,8 @@ components:
required: [categoryId, name]
properties:
categoryId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
description:
@ -1750,8 +1750,8 @@ components:
required: [topicId, title]
properties:
topicId:
type: string
format: uuid
type: integer
format: int64
title:
type: string
description:
@ -1759,8 +1759,8 @@ components:
assetIds:
type: array
items:
type: string
format: uuid
type: integer
format: int64
RecommendationSlot:
type: object
@ -1776,8 +1776,8 @@ components:
assetIds:
type: array
items:
type: string
format: uuid
type: integer
format: int64
PublisherExposureSummary:
type: object
@ -1806,8 +1806,8 @@ components:
required: [assetId, name, assetType, publisherName, version, listingStatus, licenseInfo]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
maxLength: 200
@ -1817,13 +1817,13 @@ components:
publisherName:
type: string
publisherId:
type: string
format: uuid
type: integer
format: int64
version:
type: string
versionId:
type: string
format: uuid
type: integer
format: int64
listingStatus:
type: string
enum: [listed, delisted, recalled, not_listed]
@ -1847,8 +1847,8 @@ components:
items:
type: string
categoryId:
type: string
format: uuid
type: integer
format: int64
# 用户授权与可用动作
userActions:
$ref: '#/components/schemas/AssetUserActions'
@ -2070,12 +2070,12 @@ components:
required: [licenseId, assetId, status]
properties:
licenseId:
type: string
format: uuid
type: integer
format: int64
description: 授权记录 ID
assetId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [active, expired, revoked]
@ -2096,15 +2096,15 @@ components:
required: [installationId, assetId, status]
properties:
installationId:
type: string
format: uuid
type: integer
format: int64
description: 安装记录 ID
assetId:
type: string
format: uuid
type: integer
format: int64
versionId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [installed, disabled, upgradable]
@ -2127,16 +2127,16 @@ components:
required: [authorizationSummaryId, authorizationSnapshotId, assetId, sourceVersion, sourceStatus, targetOwner, targetAction, handoffReady, expiresAt]
properties:
authorizationSummaryId:
type: string
format: uuid
type: integer
format: int64
description: 来源侧授权摘要 ID,供目标 owner 预检消费
authorizationSnapshotId:
type: string
format: uuid
type: integer
format: int64
description: 来源授权快照 ID
assetId:
type: string
format: uuid
type: integer
format: int64
sourceVersion:
type: integer
description: 来源资产版本
@ -2149,8 +2149,8 @@ components:
type: string
enum: [slot_bind, bind, asset_use]
targetWorkId:
type: string
format: uuid
type: integer
format: int64
authorizationSnapshot:
type: string
description: 授权快照摘要
@ -2180,12 +2180,12 @@ components:
format: uri
description: 目标 owner 空间落地页 URL
authorizationSummaryId:
type: string
format: uuid
type: integer
format: int64
description: 关联的来源侧授权摘要 ID
authorizationSnapshotId:
type: string
format: uuid
type: integer
format: int64
description: 关联的来源授权快照 ID
expiresAt:
type: string
@ -2207,11 +2207,11 @@ components:
targetAction:
type: string
assetId:
type: string
format: uuid
type: integer
format: int64
targetWorkId:
type: string
format: uuid
type: integer
format: int64
returnUrl:
type: string
format: uri
@ -2236,8 +2236,8 @@ components:
enum: [work, agent, knowledge_base]
description: 资产类型
sourceId:
type: string
format: uuid
type: integer
format: int64
description: 来源对象 ID(作品/智能体/知识库)
name:
type: string
@ -2251,8 +2251,8 @@ components:
type: string
maxLength: 5000
categoryId:
type: string
format: uuid
type: integer
format: int64
licenseType:
type: string
description: 许可类型
@ -2290,8 +2290,8 @@ components:
required: [draftId, status, missingItems]
properties:
draftId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [draft, unchecked, check_failed, submittable]
@ -2307,8 +2307,8 @@ components:
required: [marketPublishCheckId, status, canSubmit, expiresAt]
properties:
marketPublishCheckId:
type: string
format: uuid
type: integer
format: int64
description: 检查结果 ID(提交审核时消费)
status:
type: string
@ -2354,8 +2354,8 @@ components:
required: [requestId, status]
properties:
requestId:
type: string
format: uuid
type: integer
format: int64
description: 发布申请 ID
status:
type: string
@ -2368,8 +2368,8 @@ components:
required: [assetId, assetName, assetType, status]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
assetName:
type: string
assetType:
@ -2400,8 +2400,8 @@ components:
description: 治理影响范围
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
governanceResult:
$ref: '#/components/schemas/GovernanceResultSummary'
affectedAuthorizations:
@ -2471,8 +2471,8 @@ components:
type: object
properties:
licenseId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
description: 当前授权状态
@ -2484,8 +2484,8 @@ components:
type: object
properties:
installationId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
impact:
@ -2497,11 +2497,11 @@ components:
type: object
properties:
bindingId:
type: string
format: uuid
type: integer
format: int64
workId:
type: string
format: uuid
type: integer
format: int64
workName:
type: string
description: 脱敏作品名
@ -2514,8 +2514,8 @@ components:
type: object
properties:
taskId:
type: string
format: uuid
type: integer
format: int64
taskType:
type: string
status:
@ -2527,8 +2527,8 @@ components:
type: object
properties:
candidateId:
type: string
format: uuid
type: integer
format: int64
candidateType:
type: string
enum: [shadow_candidate, knowledge_draft]
@ -2547,8 +2547,8 @@ components:
required: [appealId, status, processingDeadline]
properties:
appealId:
type: string
format: uuid
type: integer
format: int64
status:
type: string
enum: [pending, reviewing]
@ -2569,16 +2569,16 @@ components:
required: [assetId, name, assetType, publisherName, listingStatus, reviewStatus]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
assetType:
type: string
enum: [work, agent, knowledge_base]
publisherId:
type: string
format: uuid
type: integer
format: int64
publisherName:
type: string
version:
@ -2610,16 +2610,16 @@ components:
required: [assetId, name, assetType, listingStatus, reviewStatus]
properties:
assetId:
type: string
format: uuid
type: integer
format: int64
name:
type: string
assetType:
type: string
enum: [work, agent, knowledge_base]
publisherId:
type: string
format: uuid
type: integer
format: int64
publisherName:
type: string
version:
@ -2665,8 +2665,8 @@ components:
reason:
type: string
operatorId:
type: string
format: uuid
type: integer
format: int64
operatedAt:
type: string
format: date-time
@ -2683,8 +2683,8 @@ components:
required: [previewId, actionType, scope, affectedCounts]
properties:
previewId:
type: string
format: uuid
type: integer
format: int64
description: 预览 ID(关联到后续下架/召回操作)
actionType:
type: string
@ -2732,19 +2732,19 @@ components:
required: [requestId, assetId, assetName, assetType, status]
properties:
requestId:
type: string
format: uuid
type: integer
format: int64
assetId:
type: string
format: uuid
type: integer
format: int64
assetName:
type: string
assetType:
type: string
enum: [work, agent, knowledge_base]
publisherId:
type: string
format: uuid
type: integer
format: int64
publisherName:
type: string
version:
@ -2775,8 +2775,8 @@ components:
required: [appealId, appealType, status, assetId]
properties:
appealId:
type: string
format: uuid
type: integer
format: int64
appealType:
type: string
enum: [review_rejection, delist, recall, license_revocation, usage_impact]
@ -2784,21 +2784,21 @@ components:
type: string
enum: [pending, reviewing, supplementing, maintained, restored, closed]
appellantId:
type: string
format: uuid
type: integer
format: int64
appellantName:
type: string
assetId:
type: string
format: uuid
type: integer
format: int64
assetName:
type: string
submittedAt:
type: string
format: date-time
processorId:
type: string
format: uuid
type: integer
format: int64
AdminAppealDetail:
type: object
@ -2806,8 +2806,8 @@ components:
required: [appealId, appealType, status, assetId, reason]
properties:
appealId:
type: string
format: uuid
type: integer
format: int64
appealType:
type: string
enum: [review_rejection, delist, recall, license_revocation, usage_impact]
@ -2815,13 +2815,13 @@ components:
type: string
enum: [pending, reviewing, supplementing, maintained, restored, closed]
appellantId:
type: string
format: uuid
type: integer
format: int64
appellantName:
type: string
assetId:
type: string
format: uuid
type: integer
format: int64
assetName:
type: string
assetVersion:
@ -2856,8 +2856,8 @@ components:
action:
type: string
processorId:
type: string
format: uuid
type: integer
format: int64
processedAt:
type: string
format: date-time
@ -2869,11 +2869,11 @@ components:
description: 申诉补充材料记录
properties:
supplementId:
type: string
format: uuid
type: integer
format: int64
submittedBy:
type: string
format: uuid
type: integer
format: int64
submittedAt:
type: string
format: date-time