查询工作流模板版本列表
接口说明
有效成员查询工作流模板全部版本；按版本号倒序返回草稿与已提交版本，并标记唯一生效版本
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
winnexo:ListWorkflowTemplateVersions |
none |
*全部资源
|
无 | 无 |
请求语法
POST /openapi/listWorkflowTemplateVersions HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID，公共参数；缺省时使用调用方默认租户 |
10000 |
| collaborationGroupId |
string |
是 |
协作空间 ID |
group_example |
| templateId |
string |
是 |
模板 ID |
tpl_example |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| code |
string |
业务状态码；成功为 200 |
200 |
| message |
string |
错误描述 |
请求的资源不存在 |
| requestId |
string |
请求追踪 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| templateId |
string |
模板 ID |
tpl_example |
| effectiveVersion |
string |
当前生效版本号；为空表示仅有草稿 |
v1 |
| items |
array<object> |
全部版本，按版本号倒序 |
example |
|
object |
全部版本，按版本号倒序 |
示例版本项 |
|
| version |
string |
版本号 |
v2 |
| status |
string |
版本状态：DRAFT 草稿 / SUBMITTED 已提交 |
DRAFT |
| isEffective |
boolean |
是否为当前唯一生效版本 |
false |
| name |
string |
该版本的模板名称 |
example |
| description |
string |
该版本的模板描述；v1 无版本说明时可用于展示 |
自动生成周报 |
| versionDescription |
string |
持久化的版本变更说明；为空表示未填写 |
新增审核步骤 |
| stepCount |
integer |
该版本的步骤数 |
3 |
| sourceVersion |
string |
创建该版本所基于的已提交版本号；新建 v1 为空，草稿保存或提交保留原来源版本 |
v1 |
| createdByUserId |
integer |
版本创建人用户 ID |
1 |
| updatedByUserId |
integer |
版本最后修改人用户 ID |
1 |
| submittedByUserId |
integer |
版本提交人用户 ID；草稿为空 |
1 |
| gmtCreate |
string |
版本创建时间(ISO8601) |
2026-10-19T10:00:00+08:00 |
| gmtModified |
string |
版本修改时间(ISO8601) |
2026-10-19T10:00:00+08:00 |
| gmtSubmitted |
string |
版本提交时间(ISO8601)；草稿为空 |
2026-10-19T10:00:00+08:00 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "请求的资源不存在",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"templateId": "tpl_example",
"effectiveVersion": "v1",
"items": [
{
"version": "v2",
"status": "DRAFT",
"isEffective": false,
"name": "example",
"description": "自动生成周报",
"versionDescription": "新增审核步骤",
"stepCount": 3,
"sourceVersion": "v1",
"createdByUserId": 1,
"updatedByUserId": 1,
"submittedByUserId": 1,
"gmtCreate": "2026-10-19T10:00:00+08:00",
"gmtModified": "2026-10-19T10:00:00+08:00",
"gmtSubmitted": "2026-10-19T10:00:00+08:00"
}
]
}