# RTC、SFU 会议与协作接口

这一层负责会议室、成员、发布订阅、WHIP/WHEP、聊天、白板、投屏、主持权限和会议录像。业务系统先签发短时票据，再由具体设备加入；不要把管理员令牌直接交给浏览器。

本页覆盖 **117** 个接口。每一行都回答五件事：接口地址、它做什么、何时调用、如何确认完成、谁可以调用。参数字段的精确定义以同版本 OpenAPI 为准。

> “业务接口”可以由 WebUI 或第三方系统按权限调用；“管理员接口”需要后台管理员；“内部接口/内部回调”只允许产品组件之间使用。

## RTC 公共能力

| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
| `GET /api/v2/rtc/capabilities` | 查看WebRTC SFU 规划能力。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | 无业务参数 |
| `POST /api/v2/rtc/media-sessions/{sessionId}/release` | 按媒体会话编号释放流媒体服务 WebRTC 会话。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | sessionId（必填） |
| `POST /api/v2/rtc/participants/timeout-scan` | 手动触发 RTC 成员心跳超时离线治理。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | 无业务参数 |
| `GET /api/v2/rtc/recordings` | 按会议号、名称、录制时间、状态、成员及入会设备会话分页查询录制。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId、search、participantId、deviceSessionId、state、fromUtc、toUtc、page、pageSize |
| `GET /api/v2/rtc/resources` | 查询 RTC 资源树快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | 无业务参数 |
| `GET /api/v2/rtc/room-state-model` | 查看RTC 房间状态机说明。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | 无业务参数 |
| `GET /api/v2/rtc/session/rooms/{roomId}` | 查看当前参会身份可见的房间策略与成员状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `PUT /api/v2/rtc/session/rooms/{roomId}/access-policy` | 更新会议访问、等候室与锁定策略。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、UpdateRtcRoomAccessRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/admission/status` | 查询当前设备的等候室准入状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/chat/attachments` | 上传并广播或私发会议文件、图片和视频，也可作为白板图片素材。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/chat/attachments/{attachmentId}` | 在参会身份与私发可见性校验后读取会议附件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.participate` | roomId（必填）、attachmentId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/close` | 当前主持人结束整个会议并撤销所有设备会话。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/connection-settings` | 查看当前会议的客户端 STUN/TURN 连接配置。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/endpoint-info` | 查看当前会议在线成员最近 90 秒自报的终端参数。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `PUT /api/v2/rtc/session/rooms/{roomId}/endpoint-info` | SDK 上报本机可获得的终端与实际媒体参数，不接受硬件唯一标识。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、RtcEndpointTelemetry |
| `POST /api/v2/rtc/session/rooms/{roomId}/extend` | 在预约硬截止时间内延长 RTC 会议。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、ExtendRtcMeetingRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/external-sources` | 会议成员查看当前外部媒体源，不计作参会人。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/external-sources` | 主持人将已授权已有通道加入房间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、AddRtcExternalSourceRequest |
| `DELETE /api/v2/rtc/session/rooms/{roomId}/external-sources/{bindingId}` | 主持人移出本会议外部源，不停止平台原流。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、bindingId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/external-sources/candidates` | 主持人查看业务方已授权的可接入通道。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/external-sources/candidates/{grantId}/snapshot` | 主持人按授权通道查看最新截图，不暴露源URL。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、grantId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/heartbeat` | 刷新经过设备绑定校验的 RTC 心跳。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/host/claim` | 由组织者或平台 RTC 管理员接管无人主持的会议。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、ClaimRtcHostRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/host/transfer` | 由当前主持人安全移交主持身份。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、TransferRtcHostRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/invitations` | 查询会议邀请摘要。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/invitations` | 为指定外部主体签发一次性会议接入票据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、CreateRtcMeetingInvitationRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/invitations/{invitationId}/revoke` | 撤销尚未使用的会议邀请。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、invitationId（必填）、RevokeRtcMeetingInvitationRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/join` | 使用第三方应用签发的主体票据加入 RTC 房间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`专用流程` | roomId（必填）、SecureJoinRtcRoomRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/leadership` | 查询会议组织者、当前主持人和联席主持人。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/leave` | 使当前 RTC 设备安全离会。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、SecureLeaveRtcRoomRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/participants` | 查询安全 RTC 房间成员列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/participants/{participantId}/admission` | 主持人准入或拒绝等候室成员。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、ReviewRtcAdmissionRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/participants/{participantId}/cohost` | 由当前主持人授予或收回联席主持人身份。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、SetRtcCohostRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/participants/{participantId}/moderation` | 使用可信主持人身份管理 RTC 成员。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、ModerateRtcParticipantRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/participants/{participantId}/whiteboard-access` | 主持人审批或收回成员白板书写权。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、ReviewRtcWhiteboardAccessRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/playback-ticket` | 签发会议内只读 HTTP-FLV 播放票据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/files/{fileId}/download` | 下载会议归档中的单个录像分片。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填）、fileId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/files/{fileId}/media` | 播放会议归档中的单个录像分片。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.play` | roomId（必填）、fileId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/manifest` | 查看会议音视频、白板和事件的统一时间轴回放清单。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填）、afterSequence、maxEvents |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/package` | 流式打包下载整场 RTC 会议归档。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/attachments/{attachmentId}/content` | 按录制档案权限读取本次录制实际引用的公开图片、视频、PDF或文本附件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填）、recordingId（必填）、attachmentId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/attachments/{attachmentId}/download` | 凭独立下载权限读取本次录制实际引用的公开附件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填）、recordingId（必填）、attachmentId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/files/{fileId}/download` | 下载指定录制任务确实关联的媒体分片。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填）、recordingId（必填）、fileId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/files/{fileId}/media` | 查看指定录制任务确实关联的媒体分片。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.play` | roomId（必填）、recordingId（必填）、fileId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/full-exports` | 按档案授权查看整场导出任务与可下载结果。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填）、recordingId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/full-exports/{exportId}/download` | 下载获准范围内的固定布局整场MP4。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填）、recordingId（必填）、exportId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/full-exports/{exportId}/media` | 支持HTTP Range播放获准的整场MP4。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.play` | roomId（必填）、recordingId（必填）、exportId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/manifest` | 按RecordingId查询固定原点的会议录制档案。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填）、recordingId（必填）、afterSequence、maxEvents |
| `GET /api/v2/rtc/session/rooms/{roomId}/playback/recordings/{recordingId}/package` | 按RecordingId打包公共事件、独立原轨与成员/屏幕兼容副本。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口<br>`rtc.recordings.download` | roomId（必填）、recordingId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/publications` | 查询当前房间可订阅的独立 Publication。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/publications` | 创建当前设备的独立 RTC Publication。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、CreateRtcPublicationRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/publications/{publicationId}/rtmp-ticket` | 为微信小程序签发短时 媒体服务 RTMP 发布票据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、publicationId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/publications/{publicationId}/stop` | 停止当前设备拥有的独立 Publication。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填）、publicationId（必填）、StopRtcPublicationRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/publications/{publicationId}/telemetry` | 上报独立 RTC Publication 的浏览器 getStats 实时遥测。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、publicationId（必填）、ReportRtcPublicationTelemetryRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/publications/{publicationId}/whip` | 将独立 Publication 通过 WHIP 发布到 媒体服务。 | 用户提交业务动作或配置变更时调用。 | 拿到 SDP 响应后继续检查 ICE/DTLS 和媒体会话状态，不能只看 HTTP 状态码。 | 业务接口<br>`rtc.participate` | roomId（必填）、publicationId（必填）、preferredTcp、candUdp、candTcp |
| `POST /api/v2/rtc/session/rooms/{roomId}/recording/continuous/{recordingId}/stop` | 由当前主持人停止指定持续录制任务。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填）、recordingId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/recording/continuous/current` | 已准入成员查询当前持续录制状态，启停仍限主持人。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `GET /api/v2/rtc/session/rooms/{roomId}/recording/continuous/runs` | 按房间档案权限列出持续录制任务。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/recording/continuous/start` | 由当前主持人启动房间持续录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/recording/start` | 主持人按独立 Publication 启动会议录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填）、StartRtcRoomRecordingRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/recording/stop` | 主持人按独立 Publication 停止会议录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填）、StopRtcRoomRecordingRequest |
| `GET /api/v2/rtc/session/rooms/{roomId}/recording/targets` | 通过可信参会身份查询独立 RTC 录制目标。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、includeInactive |
| `GET /api/v2/rtc/session/rooms/{roomId}/signaling/ws` | 建立绑定成员和设备身份的 RTC 参会 WebSocket。 | 页面加载、刷新状态或按条件检索数据时调用。 | 连接升级为 WebSocket 只是开始；还要处理鉴权失败、断线重连和事件序号。 | 业务接口<br>`rtc.participate` | roomId（必填）、lastSequence、replayPageSize |
| `GET /api/v2/rtc/session/rooms/{roomId}/subscriptions` | 查询当前设备的独立订阅。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/session/rooms/{roomId}/subscriptions` | 创建当前观看设备到指定 Publication 的独立订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、CreateRtcSubscriptionRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/subscriptions/{subscriptionId}/stop` | 停止当前设备拥有的独立 Subscription。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.participate` | roomId（必填）、subscriptionId（必填）、StopRtcSubscriptionRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/subscriptions/{subscriptionId}/whep` | 通过 媒体服务 WHEP 建立独立 Subscription。 | 用户提交业务动作或配置变更时调用。 | 拿到 SDP 响应后继续检查 ICE/DTLS 和媒体会话状态，不能只看 HTTP 状态码。 | 业务接口<br>`rtc.participate` | roomId（必填）、subscriptionId（必填）、preferredTcp、candUdp、candTcp |
| `POST /api/v2/rtc/session/rooms/{roomId}/token/refresh` | 轮换并续签 RTC 设备令牌。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填） |
| `PUT /api/v2/rtc/session/rooms/{roomId}/video-quality` | 主持人为单个或全部成员设置可自动适配的摄像头质量目标。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、SetRtcVideoQualityRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/whiteboard/access-request` | 申请或取消申请 RTC 白板书写权。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、RequestRtcWhiteboardAccessRequest |
| `POST /api/v2/rtc/session/rooms/{roomId}/whiteboard/lock` | 主持人锁定或解锁协作白板。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、SetRtcWhiteboardLockRequest |
| `DELETE /api/v2/rtc/webrtc` | 代理释放流媒体服务 WebRTC 会话。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | mediaServerId、id、token |

## 会议室与协作

| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
| `GET /api/v2/rtc/rooms` | 查询 RTC 房间列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | 无业务参数 |
| `POST /api/v2/rtc/rooms` | 创建 RTC 房间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | CreateRtcRoomRequest |
| `GET /api/v2/rtc/rooms/{roomId}` | 查看RTC 房间详情。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/access-tickets` | 为第三方应用主体签发一次性 RTC 入会票据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、CreateRtcMeetingInvitationRequest |
| `POST /api/v2/rtc/rooms/{roomId}/announcement` | 由平台管理员广播 RTC 会议公告。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、BroadcastRtcAnnouncementRequest |
| `PUT /api/v2/rtc/rooms/{roomId}/capacity` | 更新既有 RTC 会议容量。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、UpdateRtcRoomCapacityRequest |
| `POST /api/v2/rtc/rooms/{roomId}/chat/messages` | 发送 RTC 房间聊天消息。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、SendRtcChatMessageRequest |
| `POST /api/v2/rtc/rooms/{roomId}/close` | 关闭 RTC 房间并将成员置为离线。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/datachannel/events` | 提交 RTC DataChannel 控制事件。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、PostRtcDataChannelEventRequest |
| `GET /api/v2/rtc/rooms/{roomId}/events` | 按房间、通道和序号增量查询 RTC 事件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、channel、afterSequence、pageSize |
| `GET /api/v2/rtc/rooms/{roomId}/external-sources/available-channels` | 业务管理员查询可授权给房间的已有通道，不返回源URL。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `GET /api/v2/rtc/rooms/{roomId}/external-sources/grants` | 业务管理员查看房间当前外部源授权。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/external-sources/grants` | 业务管理员按已有ChannelId授权本会议可观看/可录制范围。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、GrantRtcExternalSourceRequest |
| `DELETE /api/v2/rtc/rooms/{roomId}/external-sources/grants/{grantId}` | 撤销外部源授权并终止本会议的接收和新增录制，不停止原流。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、grantId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/join` | 兼容入口：使用服务端可信身份加入 RTC 房间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、JoinRtcRoomRequest |
| `GET /api/v2/rtc/rooms/{roomId}/media-sessions` | 查询 RTC 房间 WHIP/WHEP 媒体会话。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、includeClosed |
| `POST /api/v2/rtc/rooms/{roomId}/moderation` | 执行 RTC 房间级批量治理。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、ModerateRtcRoomRequest |
| `GET /api/v2/rtc/rooms/{roomId}/participants/{participantId}/endpoint` | 生成 RTC 成员 WHIP/WHEP 端点。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、participantId（必填）、screen（必填） |
| `GET /api/v2/rtc/rooms/{roomId}/participants/{participantId}/events` | 按成员可见性增量查询 RTC 房间事件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、participantId（必填）、channel、afterSequence、pageSize |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/heartbeat` | 刷新 RTC 成员心跳。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/leave` | 成员离开 RTC 房间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、participantId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/media-state` | 更新 RTC 成员麦克风、摄像头和连接状态。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、participantId（必填）、UpdateRtcParticipantMediaRequest |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/moderation` | 执行 RTC 成员管理动作。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、participantId（必填）、ModerateRtcParticipantRequest |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/screen-share` | 设置 RTC 成员投屏状态。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、participantId（必填）、SetRtcScreenShareRequest |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/whep` | 代理流媒体服务 WHEP 播放 SDP 协商。 | 用户提交业务动作或配置变更时调用。 | 拿到 SDP 响应后继续检查 ICE/DTLS 和媒体会话状态，不能只看 HTTP 状态码。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、screen、preferredTcp、candUdp、candTcp、string |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/whip` | 代理流媒体服务 WHIP 推流 SDP 协商。 | 用户提交业务动作或配置变更时调用。 | 拿到 SDP 响应后继续检查 ICE/DTLS 和媒体会话状态，不能只看 HTTP 状态码。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId（必填）、screen、preferredTcp、candUdp、candTcp、string |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{participantId}/whiteboard-access` | 由平台管理员授予、拒绝或收回成员白板书写权。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、participantId（必填）、ReviewRtcWhiteboardAccessRequest |
| `POST /api/v2/rtc/rooms/{roomId}/participants/{viewerParticipantId}/subscriptions/{publisherParticipantId}/whep` | WHEP 订阅 RTC 发布流。 | 用户提交业务动作或配置变更时调用。 | 拿到 SDP 响应后继续检查 ICE/DTLS 和媒体会话状态，不能只看 HTTP 状态码。 | 业务接口<br>`rtc.participate` | roomId（必填）、viewerParticipantId（必填）、publisherParticipantId（必填）、screen、preferredTcp、candUdp、candTcp、string |
| `POST /api/v2/rtc/rooms/{roomId}/publications/{publicationId}/admin-stop` | 由平台管理员停止指定 RTC Publication。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、publicationId（必填）、StopRtcPublicationRequest |
| `PUT /api/v2/rtc/rooms/{roomId}/recording-policy` | 会议所有者或超级管理员允许/禁用本会议录制。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、RtcRecordingPolicyRequest |
| `POST /api/v2/rtc/rooms/{roomId}/recording/continuous/{recordingId}/composites/{compositeId}/retry` | 授权业务API重试失败的会后成员/屏幕兼容副本。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填）、recordingId（必填）、compositeId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/recording/continuous/{recordingId}/full-exports` | 按需排队生成固定布局、混音和公共事件字幕的整场MP4。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.manage` | roomId（必填）、recordingId（必填）、CreateRtcFullExportRequest |
| `POST /api/v2/rtc/rooms/{roomId}/recording/continuous/{recordingId}/full-exports/{exportId}/retry` | 授权业务API重试失败的整场导出。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填）、recordingId（必填）、exportId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/recording/continuous/{recordingId}/stop` | 由授权业务API停止指定持续录制任务。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填）、recordingId（必填） |
| `GET /api/v2/rtc/rooms/{roomId}/recording/continuous/current` | 查询房间当前持续录制任务。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填） |
| `GET /api/v2/rtc/rooms/{roomId}/recording/continuous/runs` | 按会议档案权限列出录制任务。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.recordings.view` | roomId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/recording/continuous/start` | 由授权业务API启动房间持续录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填） |
| `POST /api/v2/rtc/rooms/{roomId}/recording/start` | 启动 RTC 房间会议录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填）、StartRtcRoomRecordingRequest |
| `POST /api/v2/rtc/rooms/{roomId}/recording/stop` | 停止 RTC 房间会议录制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>`rtc.manage` | roomId（必填）、StopRtcRoomRecordingRequest |
| `GET /api/v2/rtc/rooms/{roomId}/recording/targets` | 查询 RTC 房间可录制的 WHIP 推流目标。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、includeInactive |
| `POST /api/v2/rtc/rooms/{roomId}/recordings/access` | 业务后端签发绑定会议和view/play/download操作的短时SDK档案票据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.recordings.view` | roomId（必填）、RtcArchiveAccessRequest |
| `GET /api/v2/rtc/rooms/{roomId}/signaling/connections` | 查询 RTC 房间当前 WebSocket 信令连接。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填） |
| `GET /api/v2/rtc/rooms/{roomId}/signaling/ws` | 兼容入口：建立设备身份绑定的 RTC WebSocket。 | 页面加载、刷新状态或按条件检索数据时调用。 | 连接升级为 WebSocket 只是开始；还要处理鉴权失败、断线重连和事件序号。 | 业务接口<br>`rtc.participate` | roomId（必填）、participantId、lastSequence、replayPageSize |
| `GET /api/v2/rtc/rooms/{roomId}/subscription-topology` | 查询 RTC WHEP 订阅拓扑。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>`rtc.view` | roomId（必填）、viewerParticipantId、includeSelf、includeInactive |
| `POST /api/v2/rtc/rooms/{roomId}/whiteboard/events` | 提交 RTC 白板同步事件。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>`rtc.participate` | roomId（必填）、PostRtcWhiteboardEventRequest |

## 接口字段与示例

本页故意先讲清业务用途，不把几百个字段塞进说明文字。真正编码时，请使用与部署版本一起提供的 OpenAPI 和 Postman 资产查看请求体、响应体、枚举、文件类型与示例；不要拿网站最新契约调用旧版本服务。