API 参考
Seatmap.pro Booking API 是 REST API,通过请求头中的 API 密钥进行身份验证。当前版本为 v2。
交互式 API 浏览器
在浏览器中,通过 Booking 服务提供的交互界面探索和测试 API:
- 交互式 API 浏览器:全部版本入口。
- API v2 — 预订:最新。
- API v2 — 管理:最新。
- API v1:旧版。
静态参考
- REST API v2 参考:根据 OpenAPI 生成的完整端点参考。
- REST API v1 参考:旧版。
活动系列与自助选座
使用 Seatmap.pro Booking API 从一个模板创建赛季或赛事活动系列,复制价格、座位分配和属性,让获授权人员在每场活动中自助选座。通过服务器端会话确认保存人员引用及业务属性,按活动或整个系列读取预订,处理重复引用、开场截止和释放操作,并保留门户系统对身份的控制。
预订会话
使用 Seatmap.pro 服务器端预订会话,为一个活动保存买家的座位和通用入场名额,刷新页面后恢复选择并避免重复预订。从浏览器创建、锁定、解锁和结算,由后端支付后确认;查看生命周期、到期倒计时、幂等规则、错误响应及私有管理接口,正确处理购物车冻结、取消和库存释放。
直接销售端点
通过 Seatmap.pro Booking API 的直接销售端点,在一次原子调用中将可用座位或通用入场名额标记为已售,跳过标准销售流程的锁定步骤。比较预订会话、标准销售与直接销售的适用场景,查看请求字段、响应状态、库存限制和授权要求,为后台销售、赠票及外部 POS 导入选择正确流程。
座位图克隆端点
通过 Seatmap.pro Booking API 异步克隆场地座位图,复制完整布局、区域、排、座位元数据和价格区域模板。使用私密 API 密钥启动克隆,取得操作 UUID 后轮询结果,识别运行、完成和失败状态,并读取新的座位图 ID,为布局变体、相似场地或测试创建独立副本。