草稿
在开启了发布的模型上,每次保存都会新增一个草稿版本,API 仍然返回已发布的版本。在发布之前,你可以看到 API 会如何提供该草稿。
保存做了什么
新记录从版本 1 开始,处于草稿状态。每次保存都会新增一个版本,公开 API 会继续返回已发布的版本,直到你按版本 id 发布某个具体版本。发布是按模型开启的。在没有开启发布的模型上,更改会立即生效。
以某个特定密钥预览
窗格可以以你自己的控制台会话运行,也可以以收窄到所选作用域的该会话运行,或者以你粘贴进来的公开密钥运行。你自己的会话可以读取所有字段,因此要查看某个API 密钥会得到什么,请粘贴该密钥。
从你自己的应用读取草稿
传入 preview: true的查询会读取最新草稿,其密钥必须持有 drafts:read作用域。文档中的推荐做法是为预览部署使用单独的公开密钥,该密钥持有此作用域,而生产密钥没有。没有此作用域的密钥发出的预览请求,会因权限错误被拒绝。草稿读取绝不会存入响应缓存。