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

# API更新日志 - 更新、功能和重大变更

> OddsPapi API更新日志。新功能、改进、错误修复和重大变更。跟踪WebSocket和REST API更新以进行体育博彩数据集成。

我们持续改进Odds API。
此页面列出**新功能**、**变更**、**修复**和**重大变更**。

<Note>
  所有时间戳均为UTC。
  如果变更影响数据形状或行为，将标记为**重大变更**。
</Note>

***

## 2026-04-09

### 新增

* **赛事视图：`venue` 场馆部分** — 所有赛事响应新增嵌套对象，包含 `venueId`、`venueName` 和 `venueLocation`。按语言翻译。
* **赛事视图：`clock` 时钟部分** — 所有赛事响应新增嵌套对象，包含 `currentPeriod`、`currentTime`、`remainingTime`、`remainingTimeInPeriod` 和 `stopped`。在赛事填充时钟数据之前，所有键均为 `null`。
* **赛事视图：`participant1ShortName` / `participant2ShortName`** — 赛事响应 `participants` 部分新增字段，来源于翻译后的参赛方数据。
* **赛事视图：`seasonRound`** — 赛事响应 `season` 部分新增字段。
* **期货视图：`marketId`** — 期货响应 `market` 部分现包含来自期货表的 `marketId`。名称字段（`marketName`、`marketType`、`playerMarket`、`participantMarket`）暂时为 `null`。
* **参赛方端点：`participantShortName`** — `GET /{lang}/participants` 响应现包含每个参赛方的 `participantShortName`。
* 新REST端点：**`GET /{lang}/venues?venueIds=...`** — 返回带有翻译后 `venueName` 和 `venueLocation` 的场馆数据。
* 新WebSocket频道：**`clocks`** — 按赛事传递实时时钟更新（与 `scores` 相同的路由：按 `fixtureId`、运动、赛事过滤）。支持恢复/重放。

### 重大变更

* **赛事响应结构变更** — 所有赛事端点（REST和WebSocket）现包含三个新顶级键：`venue`（对象）、`clock`（对象），以及更新的 `participants` / `season` 部分。严格解析赛事响应的客户端应更新其模型。
  * `season` 现包含 `seasonRound: integer | null`
  * `participants` 现包含 `participant1ShortName: string | null` 和 `participant2ShortName: string | null`
  * `venue: { venueId, venueName, venueLocation }` 在 `season` 之后添加
  * `clock: { currentPeriod, currentTime, remainingTime, remainingTimeInPeriod, stopped }` 在 `scores` 之后添加
* **期货响应结构变更** — `market.marketId` 现已填充（整数或null），不再始终为 `null`。

***

## 2025-12-12

### 新增

* WebSocket **恢复和重放**支持，使用`entryId`游标
* 新WebSocket频道：
  * `injuries`
  * `lineups`
  * `stats`
* WebSocket网关的AsyncAPI 3.0参考

### 改进

* 减少了`odds`和`scores`的WebSocket延迟
* 改进了`sportIds`、`tournamentIds`和`bookmakers`的过滤

### 修复

* 修复了一些`odds`更新在没有博彩公司门控的情况下交付的问题
* 修复了某些赛事在过渡期间`live`标志不正确的问题

***

## 2025-11-28

### 重大变更

* `odds.payload.odds`键现在**始终是博彩公司范围的**
  * 期望扁平结构的旧客户端必须更新

### 新增

* 支持`receiveType: "binary"`（MessagePack）
* 在所有更新消息中添加了`entryId`

***

## 2025-11-10

### 新增

* 初始WebSocket网关
* 频道：
  * `fixtures`
  * `scores`
  * `odds`
  * `bookmakers`