跨实例场地库联合
场地库联合功能允许 Seatmap 实例通过 HTTP 从另一 Seatmap 实例拉取场地库内容。适用于自托管部署,希望使用其他实例发布的座位图库,又不复制发布者数据库的情况。
本页面向用户介绍功能。技术配置步骤请联系 Seatmap 团队或您的运营人员。
角色
- 来源实例发布场地库内容,并为使用方实例授予联合访问权限。
- 使用方实例配置来源 URL 和访问凭据,按需拉取场地库内容,与本实例条目一起显示。
一个实例可以同时作为来源和使用方,也可以只承担其中一个角色。
工作流程
- 来源实例的全局管理员为使用方授予联合访问权限。
- 使用方运营人员保存凭据并配置来源 URL。
- 使用方用户浏览场地库时,联合条目与本实例条目出现在同一网格中。
- 用户复制联合场地时,使用方通过 HTTPS 获取座位图和素材,写入自己的数据库和素材存储,并记录来源。
强制规则
- 身份验证:每个联合请求均携带凭据,来源验证后才提供内容。
- 速率限制:来源实例按凭据限流,默认每分钟 60 次请求,可配置。
- 审计:每次成功或失败的拉取都在来源端记录,供审核。
- 快照语义:联合副本固定在复制时的状态。此后副本归使用方所有,来源更新不会同步。
不参与联合的内容
- 用户身份:联合仅传递数据,用户不跨实例登录。
- 定价、活动、预订:与实例内场地库相同,仅传递布局。
- 多来源拉取:当前版本每个使用方实例最多配置一个来源。
运维说明
- 凭据可撤销,但不支持直接轮换。更换时需撤销旧凭据、签发新凭据,使用方必须更新配置。
- 来源不可访问时,使用方不显示联合条目;本实例场地库条目仍正常工作。
- 来源信息始终指向最初来源。即使联合副本之后又在使用方实例内部被复制,二次副本仍引用原始实例。