系统总览
数据内容
本 API 提供以桌为单位订阅游戏桌数据,每桌可以分开订阅。每桌提供分为「管理数据」和「游戏数据」两大类:
管理数据包含开桌、关桌、维护、封面照片更新等管理相关操作。
游戏数据包含班次、靴、局数据,以及发牌、开骰等每个动作的记录。
接口分类
本 API 所有数据都提供「主动推送」和「被动查询」两种方式:
主动推送:向我们 AMQP 接口订阅,事件发生当下即时发送事件通知。
被动查询:事件发生后,可以通过 gRPC / HTTP API 获取数据。
数据结构
所有数据内容会分为以下四种对象:
- GameProvide(游戏桌):管理数据
- ShiftRecord(班次):游戏该班次信息
- ShoeRecord(靴次):该靴信息
- RoundRecord(局):该局信息
数据流程
游戏桌 (GameProvide)
↓
班次 (ShiftRecord)
↓
靴次 (ShoeRecord) [部分游戏可能没有]
↓
局 (RoundRecord)
一个班次通常包含多靴、一靴可以多局。对于没有靴的游戏,只会有班次和局数据,一班次包含多局。
注意事项
- 所有数据都有时间戳记,方便追踪和查询