Skip to content

流程版本 API ​

编辑流程时产生开发版本。发布后产生供公开接口使用的生产版本。版本接口让你查看历史、发布当前内容,或从旧内容创建一个新的当前版本。

路径前缀:/api/projects/{projectId}/flows/{flowId}。

方法后续路径做什么
GET/versions列出版本,可用 track 筛选
GET/versions/{version}读取某个版本及其流程内容
POST/publish发布当前开发版本
POST/versions/{version}/rollback以旧版本内容创建新的当前版本

发布需要什么 ​

发布请求体中的 expectedDevelopmentVersion 应等于你刚读取到的开发版本号。可选的 remark 是本次发布说明:

json
{
  "expectedDevelopmentVersion": 3,
  "remark": "修正订单处理步骤"
}

服务器会先检查流程是否能够执行,以及它引用的类库是否可用。版本已变化、项目已归档或校验失败时,发布不会成功。

回滚要怎样理解 ​

回滚请求还需给出 track(development 或 production)和 expectedHeadVersion。它不会抹掉中间版本,而是生成一个新版本。若当前版本已变化,请重新读取历史,再决定是否继续。

先读版本与发布,会更容易理解何时保存、何时发布。

SereinFlow 使用与开发文档