可靠性与运维 - 正常运行时间、状态与事件响应

OddsPapi 专为基于数据源进行交易的团队而构建，因此可靠性是首要关注点。本页说明平台如何保持可用、如何监控它，以及在出现问题时如何联系我们。

---

​

实时状态与事件历史

平台的实时状态、正在进行的事件以及历史正常运行时间均发布在我们的状态页上： 在状态页订阅，即可在发生事件和计划维护时收到通知。

---

​

面向可用性的架构

平台经过设计，任何单点故障都不应中断您的数据流：

• WebSocket 优先传输 —— 持久网关以最小延迟流式传输更新，避免 REST 轮询的开销与间隙。
• REST + WebSocket 冗余 —— REST 快照与实时数据流是通往同一数据的两条独立路径。如果数据流中断，REST 可使您的状态保持最新。
• 恢复与重放 —— 短暂断连后，客户端从其最后游标恢复并重放错过的更新，无需完整刷新。参见恢复和重放。
• 确定性恢复 —— 当无法重放时，网关发出 snapshot_required，客户端从快速的 REST 快照重建状态。恢复是一条明确的、经过设计的路径 —— 而非错误状态。

---

​

为交易级故障转移而设计

恢复是有界且可预测的，而非尽力而为：

• 网关缓冲一个重放窗口（resumeWindowMs），因此短暂中断可无数据丢失地恢复。
• 如果您的游标超出该窗口，单次 REST 快照即可一次性恢复完整状态。
• 博彩公司连接状态通过 staleOdds 标志明确呈现，因此您始终知道某个价格何时可能不再是最新的。

这意味着最坏情况下的恢复是一次快速、明确定义的 REST 快照，而非无限期的中断。完整的恢复流程参见恢复和重放。

---

​

监控与运维责任

OddsPapi 为您提供安全运行所需的信号；您的客户端应据此采取行动：

• 在基于某个价格进行交易前，按博彩公司跟踪 staleOdds 标志。
• 处理 snapshot_required 和重连逻辑（参见恢复和重放模板）。
• 遵守速率限制和 WebSocket 连接限制；如需为分布式系统提高限额，请联系支持。
• 关注状态页以了解平台级事件。

---

​

支持与事件响应

报告问题时，请提供您的 apiKey 组、受影响的频道或端点、时间戳（UTC），以及任何 serverEpoch / entryId 值 —— 这些可帮助我们快速追踪您的会话。