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

# WebSocket 关闭代码 - 连接为何关闭以及如何处理

> Apexium API WebSocket 的每个关闭代码、建立连接时的拒绝，以及您的客户端对每种情况应如何处理。

关闭连接之前，服务器会发送一个说明原因的帧：`error` 帧，或在重启前发送 `reconnect` 帧。

```json theme={null}
{ "type": "error", "error": "limit_exceeded", "message": "Fixture limit reached: 500 per account across its connections", "connectionId": "3d9a7f52-…" }
```

同样的值也是关闭原因。与所有 `error` 帧一样，它带有该连接的 [`connectionId`](https://docs.apexiumbet.com/zh/websocket/overview#登录)。

| 代码 | 原因 | 含义 | 处理方式 |
| - | - | - | - |
| `4001` | `bad_login`、`login_failed`、`login_timeout` | 登录帧无效、密钥被拒绝，或 10 秒内没有登录 | 修正登录。不要循环重试被拒绝的密钥：参见[登录失败](#登录失败) |
| `4002` | `backpressure` | 连接读取过慢 | 重连，重新加载行情频道，并加快读取。参见 [4002](#4002) |
| `4003` | `access_revoked` | 密钥、API 访问权限或账户已不再有效 | 不要用这个密钥重连 |
| `4004` | `limit_exceeded` | 密钥的连接数、账户的赛事数或连接的投注单选项数超出限制 | 减少关注的赛事或关闭其他连接，然后重连。参见 [4004](#4004) |
| `1011` | `internal_error` | 服务器处理某个帧时出错 | 使用退避策略重连 |
| `1012` | `server_restart` | 服务器正在重启；之前已发送 `reconnect` 帧 | 立即重连 |
| `1013` | `public_api_disabled` | API 因维护或事故而关闭 | 使用退避策略重连；查看[状态页面](https://apexiumbet.instatus.com) |

没有帧的代码（例如 `1006`）表示连接被切断：使用退避策略重连。

### 4002

当连接的发送缓冲区超过 4 MB，或持续非空超过 5 秒时，Apexium 会关闭该连接。其他客户端会继续接收。

您的客户端可能看到 `1006` 而不是 `4002`：关闭帧排在已满的缓冲区之后，在它到达之前连接就被切断了。请把紧随突发流量之后出现的 `1006` 当作 `4002` 处理。

无论哪种情况，都要从 `/v1/{lang}` 重新加载行情频道：部分变化没有送达。如何跟上数据流，参见[行情频道](https://docs.apexiumbet.com/zh/websocket/feed-channels.md#读取过慢会被关闭)。

### 4004

| 限制 | 值 |
| - | - |
| 每个 API 密钥的连接数 | 8 |
| 每个账户的赛事数，所有连接合计 | 500 |
| 每个账户的投注单选项数，所有连接合计 | 50 |

赛事限制只计算 `fixtureIds`；`sportIds` 和 `tournamentIds` 不计入。它在登录时以及每次添加赛事的 `subscribe` 时生效。被拒绝的 `subscribe` 不会保留新选择的任何部分。

## 建立连接时的拒绝

有些拒绝发生在 WebSocket 打开之前，以对升级请求的 HTTP 响应形式返回：

| 状态码 | `code` | 含义 | 处理方式 |
| - | - | - | - |
| `429` | `RATE_LIMITED` | 来自您地址的登录失败次数过多 | 等待 `Retry-After` 秒 |
| `503` | `PUBLIC_API_DISABLED` | API 已关闭 | 使用退避策略重试 |

### 登录失败

登录失败与 REST 认证失败合并计数：同一地址在一分钟内失败 20 次后，在这一分钟结束之前，来自该地址的连接会被拒绝。参见[限制](https://docs.apexiumbet.com/zh/api-reference/limits.md#认证失败)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.