orders 频道发送您 API 密钥所属账户的订单:登录后立即发送一份快照,之后订单每次变化都发送完整的订单。
快照
紧接在login_ok 之后,您会收到:
orders 包含每个进行中的订单,以及过去 24 小时内发生过变化的每个订单。每个订单的结构与 GET /v1/orders/{id} 相同。
变化
订单每次变化都会再次发送完整的订单:id,保留 version 最高的订单,忽略 version 更低或相同的订单:同一个 version 可能到达两次。
恢复
eventId 用于恢复。请保存您收到的最高 eventId,包括快照中的那个。重连时,用它登录:
- 在窗口内。 错过的变化最多 1 000 个,且最早的一个不超过 10 分钟:发生过变化的订单会以
order消息发送,之后是实时变化。不会发送快照。 - 在窗口外。 您会收到
{ "type": "snapshot_required", "reason": "resume_window_exceeded", "channels": ["orders"] },然后是一份新快照。请用它替换您持有的内容。
sinceEventId 的登录总是从快照开始。
不订阅该频道时
在channels 中列出频道但不含 orders 的登录不会收到这些内容。不带 channels 的登录覆盖所有频道,包括 orders。