> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

> OddsPapi 如何为交易提供可靠的实时数据：冗余架构、实时状态页、恢复设计、支持响应和事件处理。

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

<Info>
  具体的正常运行时间目标、支持响应时间和补偿条款按 B2B 客户协议单独约定。请联系 [contact@oddspapi.io](mailto:contact@oddspapi.io) 讨论适合您用例的 SLA 条款。
</Info>

***

## 实时状态与事件历史

平台的实时状态、正在进行的事件以及历史正常运行时间均发布在我们的状态页上：

<Card title="OddsPapi 状态页" icon="signal" href="https://oddspapi-v5.instatus.com">
  实时可用性、事件报告和正常运行时间历史 —— 订阅以获取更新。
</Card>

在状态页订阅，即可在发生事件和计划维护时收到通知。

***

## 面向可用性的架构

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

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

***

## 为交易级故障转移而设计

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

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

这意味着最坏情况下的恢复是一次**快速、明确定义的 REST 快照**，而非无限期的中断。完整的恢复流程参见[恢复和重放](/zh/websocket/resume-replay)。

***

## 监控与运维责任

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

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

***

## 支持与事件响应

| 渠道                                                | 用途                 |
| ------------------------------------------------- | ------------------ |
| [support@oddspapi.io](mailto:support@oddspapi.io) | 技术支持、集成帮助、事件报告     |
| [contact@oddspapi.io](mailto:contact@oddspapi.io) | API 访问、SLA 条款、提高限额 |
| [状态页](https://oddspapi-v5.instatus.com)           | 实时可用性与事件更新         |

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