> ## 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.

# 从 OddsPapi 迁移 - 迁移到 Apexium API 时有哪些变化

> 将 OddsPapi v5 客户端迁移到 Apexium API：REST 和 WebSocket 的主机、密钥和端点会变化；路径、数据内容和标识符不变。

Apexium API 的行情数据就是 OddsPapi v5。为 OddsPapi 编写的客户端可以保留其数据模型和解析逻辑。变化的是连接方式以及可以访问的部分。

## 不变的内容

* 行情数据的**路径和参数**，只是换了新的前缀。
* REST 和 WebSocket 行情频道上的**响应和数据内容**。
* **标识符。** `fixtureId`、`outcomeId`、`playerId`、`sportId`、`tournamentId` 都是 OddsPapi 的，也是您下单所用的标识符。
* **WebSocket 消息封装**：`{ channel, type, payload, ts }`。
* **语言**：同样的八种，作为路径的第一段。参见[语言](https://docs.apexiumbet.com/zh/api-reference/overview.md#语言)。

## REST

| | OddsPapi v5 | Apexium |
| - | - | - |
| 基础 URL | `https://v5.oddspapi.io/{lang}` | `https://api.apexiumbet.com/v1/{lang}` |
| 密钥 | 您的 OddsPapi 密钥 | 您的 Apexium 密钥，放在 `x-api-key` 头中 |
| 端点 | OddsPapi v5 的全部端点 | [参考文档](https://docs.apexiumbet.com/zh/api-reference/market-data.md)中的行情数据路径；不提供映射、结算、串关、期货和媒体 |
| 参数 | 全部 | 每个参考页面中列出的参数；其他参数会被丢弃 |
| 博彩公司 | 您 OddsPapi 套餐中的博彩公司 | 您 Apexium 账户的博彩公司，对 API 关闭的除外 |

响应原样返回。OddsPapi 自己的文档 [docs.oddspapi.io](https://docs.oddspapi.io) 仍是每个字段的参考。

## WebSocket

| | OddsPapi v5 | Apexium |
| - | - | - |
| URL | `wss://v5.oddspapi.io/ws` | `wss://api.apexiumbet.com/v1/ws` |
| 密钥 | 登录中的 `apiKey` | 登录中的 `apiKey`，即您的 Apexium 密钥 |
| 行情频道 | `odds`、`fixtures`、`scores`、`clocks`、`bookmakers`、`currencies`，以及期货、阵容、伤病、统计和事件频道 | `odds`、`fixtures`、`scores`、`clocks`、`bookmakers`、`currencies` |
| 账户频道 | 无 | `orders`、`balance`、`betslip` |
| 登录中的 `bookmakers` | 缩小博彩公司范围 | 被忽略：您会收到您账户的博彩公司 |
| 登录中的 `futureIds` | 要关注的期货 | 被忽略 |
| `receiveType` | `json`、`binary`、`zstd`、`zstd-dict` | `json`、`binary`、`zstd`；生产环境只接受 `zstd` |
| 恢复 | 每个频道的 `serverEpoch` 和 `lastSeenId`，来自 `entryId` | 行情频道没有恢复：收到 `snapshot_required` 时从 `/v1/{lang}` 重新加载。`orders` 用 `sinceEventId` 恢复 |
| 登录之后 | 一条 `access` 消息 | 一个 `login_ok` 帧，包含已应用的选择和限制 |
| 每个密钥的连接数 | 5 | 8 |

> [!WARNING]
>
> **关闭代码 `4003` 的含义不同。** 在 OddsPapi，它表示连接过多。在 Apexium，它表示密钥或账户已不再有效，您不得再用它重连。Apexium 的连接数限制是 `4004`。参见[关闭代码](https://docs.apexiumbet.com/zh/websocket/close-codes.md)。

行情消息不带 `entryId`，也不带代理时间戳。`ts` 是 Apexium 收到该消息的时间。

## 检查清单

1. 将 REST 指向 `https://api.apexiumbet.com/v1/{lang}`，并在 `x-api-key` 中发送您的 Apexium 密钥。
2. 移除对未提供端点的调用。
3. 将 WebSocket 指向 `wss://api.apexiumbet.com/v1/ws`，并用 `receiveType: "zstd"` 登录。
4. 移除行情频道的恢复逻辑；改为在收到 `snapshot_required` 时从 `/v1/{lang}` 重新加载。参见[行情频道](https://docs.apexiumbet.com/zh/websocket/feed-channels.md)。
5. 将 `4003` 视为最终状态，将 `4004` 视为触及限制。


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