OpenBot v1.1.0-rc.1 的 API 路径变更会影响哪些集成?

作者:百宝袋

时间:2026-11-17

浏览:595

OpenBot v1.1.0-rc.1 启动时执行不可逆数据库迁移,PostgreSQL 采用两个受限角色,早期 API 迁至 /api/v2/。

文章目录

OpenBot v1.1.0-rc.1 将早期 API 集中至 /api/v2/。脚本、代理和 WebSocket 客户端会受到影响,旧端点是否保留应以对应版本的接口定义和发行说明为准。

OpenBot 产品封面

为什么程序回退不能代替数据恢复

OpenBot v1.1.0-rc.1 在启动时执行数据库迁移,其中包括为组织、团队、代理和任务运行准备的数据结构。旧表虽然仍留在库中,但部分数据已迁移到新表,旧表不再继续写入。官方给出的回退途径是恢复升级前备份。

OpenBot v1.1.0-rc.1 发行记录

数据库连接有了什么前提

数据库迁移为应用引入 openbot_app 和 openbot_system 两个无法登录的角色,再由 OpenBot 的数据库登录角色切换使用。发布说明允许由应用登录创建,或由管理员预先创建。两个角色都不能是超级用户,也不能绕过行级安全。

连接池为何也会影响启动

安装了数据库连接池的环境涉及 role 启动参数。连接池需要传递该参数,以便服务确认查询运行在要求的角色下。官方说明 Compose 与 openbot-bundle 已配置这部分;其他部署环境的设置取决于自身连接路径。

API 路径变化涉及哪些调用方

旧 API 收拢到 /api/v2/,未被保留的旧地址返回 404。具体 HTTP 接口对应 api/openapi.yaml,Socket 客户端对应 api/asyncapi.yaml。逐路径放行的反向代理还涉及 WebSocket 升级和发行说明明确保留在 /api/v2/ 之外的地址,不能只做字符串前缀替换。

候选版的适用范围

这份说明针对 v1.1.0-rc.1 的部署和集成兼容性。候选版的数据库状态、连接角色和接口路由分别会影响恢复、启动与调用,三者可根据实际部署条件评估。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›