Skip to content
VendingAPI

WebSocket 应用端同步协议

概览

Section titled “概览”

WebSocket 用于应用端实时同步订单状态、支付状态、出餐流程、微波炉加热进度和取餐结果。协议采用 Pusher Channels 风格的消息信封、连接事件、订阅事件和私有频道鉴权方式，便于移动端复用成熟的事件模型。

命令类操作不通过 WebSocket 发起。创建订单、支付、出餐和加热任务必须调用业务 HTTP 服务，WebSocket 只负责把结果推送到应用端。

章节

Section titled “章节”
连接 WebSocket endpoint、协议参数和 Pusher 风格连接建立事件。
鉴权 私有频道鉴权、订阅请求和 subscription succeeded 事件。
频道 用户、订单和设备 presence channel 命名规则。
事件 订单支付、出餐、加热、取餐和退款事件。
可靠性 Heartbeat、错误码、重连和至少一次投递规则。