跨实例场地库联合

场地库联合功能允许 Seatmap 实例通过 HTTP 从另一 Seatmap 实例拉取场地库内容。适用于自托管部署,希望使用其他实例发布的座位图库,又不复制发布者数据库的情况。

本页面向用户介绍功能。技术配置步骤请联系 Seatmap 团队或您的运营人员。

角色

  • 来源实例发布场地库内容,并为使用方实例授予联合访问权限。
  • 使用方实例配置来源 URL 和访问凭据,按需拉取场地库内容,与本实例条目一起显示。

一个实例可以同时作为来源和使用方,也可以只承担其中一个角色。

工作流程

  1. 来源实例的全局管理员为使用方授予联合访问权限。
  2. 使用方运营人员保存凭据并配置来源 URL。
  3. 使用方用户浏览场地库时,联合条目与本实例条目出现在同一网格中。
  4. 用户复制联合场地时,使用方通过 HTTPS 获取座位图和素材,写入自己的数据库和素材存储,并记录来源。

强制规则

  • 身份验证:每个联合请求均携带凭据,来源验证后才提供内容。
  • 速率限制:来源实例按凭据限流,默认每分钟 60 次请求,可配置。
  • 审计:每次成功或失败的拉取都在来源端记录,供审核。
  • 快照语义:联合副本固定在复制时的状态。此后副本归使用方所有,来源更新不会同步。

不参与联合的内容

  • 用户身份:联合仅传递数据,用户不跨实例登录。
  • 定价、活动、预订:与实例内场地库相同,仅传递布局。
  • 多来源拉取:当前版本每个使用方实例最多配置一个来源。

运维说明

  • 凭据可撤销,但不支持直接轮换。更换时需撤销旧凭据、签发新凭据,使用方必须更新配置。
  • 来源不可访问时,使用方不显示联合条目;本实例场地库条目仍正常工作。
  • 来源信息始终指向最初来源。即使联合副本之后又在使用方实例内部被复制,二次副本仍引用原始实例。

另请参阅

输入功能、设置、端点或 SDK 方法。