版本与部署

草稿、不可变版本、部署、slug,以及决策的停用、复制和删除——还有你的 API 客户端在每一步看到的内容。

每个决策都有一个可编辑的草稿和一段不可变版本的历史。API 始终运行当前生效的版本;草稿只有在你部署后才会进入生产环境。

决策的组成

属性规则
名称1 到 80 个字符。
Slug端点:POST /v1/decisions/{slug}。小写字母、数字和单个连字符,最多 64 个字符。在工作区内唯一。
描述可选,最多 500 个字符。
草稿你正在编辑的 schema。
版本每次部署创建的不可变快照:v1、v2……
状态Draft、Live 或 Disabled。

生命周期

 Draft ──deploy──▶ Live (v1) ──deploy──▶ Live (v2) ──deploy──▶ …
                      │   ▲
               disable│   │enable
                      ▼   │
                    Disabled
状态POST /v1/decisions/{slug} 返回什么
草稿——从未部署409 DECISION_NOT_DEPLOYED
已上线200,附带当前生效版本的回答;version 指明是哪个版本
已停用409 DECISION_DISABLED
已删除(或未知 slug)404 DECISION_NOT_FOUND

草稿与自动保存

编辑器和可视化构建器编辑的是同一个草稿。修改会在你最后一次编辑约 1.5 秒后自动保存——前提是草稿有效;否则保存栏会列出问题,并附带跳转到错误链接。

如果在你打开决策后有队友(或另一个标签页)保存了它,你的保存会被拒绝,而不会覆盖对方的修改:保存栏会显示其他人已保存了此决策,并提供加载当前版本。

保存草稿永远不会改变生产环境。

部署

部署(在决策的部署标签页中)会把当前草稿快照为版本 n + 1,并立即使其生效——正在使用的客户端会在下一次调用时切换到它。未保存的编辑会先被保存;存在 schema 问题的草稿无法部署。

  • 版本是不可变的:它们无法被编辑或删除。
  • 响应中的 version 字段以及每条执行记录都会记录作答的版本。
  • 版本历史列出所有版本(已上线或已归档)及其完整 schema。
  • 一个版本会按照部署时的样子持续运行。当 Dcision 收紧某条校验规则时——v0.3 会根据规则所比较的选项、级别和范围来检查规则的值——新规则会在你下次保存或部署草稿时生效,永远不会作用于已上线的版本。
  • 部署与对决策的所有修改一样,需要 Member 或更高的角色——参见团队、角色与账户。

回滚

目前还没有一键回滚。要恢复到之前的行为,请在版本历史中打开该版本的 schema,把草稿改回它的样子并部署——这会以旧逻辑创建一个新的版本号。

Slug

  • 创建决策时,slug 会根据其名称生成:去除重音、转为小写,其他字符都变成连字符——“Lead Qualification!” 会变成 lead-qualification。如果该 slug 已被占用,会添加后缀:lead-qualification-2。
  • 在首次部署之前你可以修改 slug。之后它就会被锁定:客户端在调用它,改名会导致它们出错(409 CONFLICT——“The slug can't change after the first deploy.”)。
  • Slug 在每个工作区内唯一。两个工作区可以都有一个 lead-qualification 决策:由 API 密钥决定运行哪个工作区——也就是哪个决策。

停用与启用

停用端点会停止一个已上线的决策,且不会丢失任何内容:调用会得到 409 DECISION_DISABLED,直到你点击启用端点,它会再次提供同一个生效版本。只有部署过的决策才能被启用。

复制

复制副本会把草稿(而不是版本)复制到一个名为“名称 (copy)”的新决策中,它有自己的 slug,没有任何版本。它会计入你套餐的决策数量上限。

删除

删除会移除该决策及其版本和执行历史。对其 slug 的调用会立即以 404 DECISION_NOT_FOUND 失败,该 slug 也会空出来,可供新决策使用。此操作无法撤销。

套餐限制

每个工作区的决策数量取决于套餐——Genesis 为 2 个,Developer 为 10 个,Growth 和 Enterprise 不限。超出上限时创建或复制会以 402 PLAN_LIMIT_REACHED 失败;请删除一个决策或升级。已停用和草稿状态的决策同样计入。

本页内容