变更记录
文档中心版本、接口版本与已知变更；破坏性变更的兼容窗口。
本页记录文档中心与公开接口的版本变化，说明每次变更的影响面与迁移窗口。
文档中心
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.2.0 | 2026-10-26 | 新增按调用方限流（429 rate_limited + Retry-After）；SDK 支持 packetLossRate 上报并展示在质量总览与通话调查；录制对象存储增加文件校验与回读；API 错误的 sdkCode 统一为声网负数口径 |
| 1.1.0 | 2026-10-26 | /v1/tokens/verify 改为诊断响应（200 + valid:false/rejection/sdkCode）；time:0 仅踢下线；maxIdleTime 语义改为空闲超时；未知协作者返回 404 collaborator_not_found；错误码统一声网负 sdkCode，并补充 code/key/retryable；水晶球补充 alarmSemantics |
| 1.0.0 | 2026-10-26 | 首个正式版本：快速开始、核心概念、频道管理、Token、云端录制、旁路推流、水晶球、回调、REST API 参考、SDK 指南、错误码、FAQ 与变更记录；中英双语；静态站自带搜索与站内导航 |
公开接口版本
| 接口 | 版本 | 说明 |
|---|---|---|
| IM RTC Provider | 1.0.0 | IM ↔ RTC 的唯一边界：getRTCTokenInfo / getUserIdsWithRTCUids，两个方法可独立配置与回退 |
| REST API（OpenAPI 3.1） | 1.0.0 | 控制面 REST 接口，REST API 参考的唯一来源 |
| 错误码 | 1.0.0 | code / HTTP / sdkCode / retryable，错误码页的唯一来源 |
| 回调 | 1.0.0 | 事件信封、事件码 101–203、签名头与重试计划 |
| 水晶球指标 | 1.0.0 | 指标定义、阈值、告警分档、实时窗口与刷新节奏 |
| 领域模型 | 1.0.0 | 资源模型、枚举与不变量 |
Token 格式（nrt1.<payload>.<hmac>）是 ni-meet 自有实现，与声网 AccessToken2 语义对齐，但不承诺字节兼容。因此 Token 格式变化不算公开接口的破坏性变更，但需要所有媒体面同步升级。
兼容策略
- IM RTC Provider：破坏性变更会发布新版本并双发 90 天；1.x 内只新增可选字段，并在本页记录。
- REST API / SDK：新增可选字段属于兼容变更；删除字段、修改语义或新增必填字段视为破坏性变更，提前公告并保留旧行为。
- 文档中心：页面 URL 发布后保持稳定；页面拆分时保留旧路径跳转。
- SDK：方法、事件与错误名视为公开 API，重命名等同破坏性变更。
版本记录方式
每次公开接口变更都会在本页追加一条记录，写明变更内容、影响面与迁移方式；详细兼容窗口见 版本与兼容。