导航
实时音视频
搜索目录或文档标题搜索目录或文档标题
实时音视频
产品动态
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
实时消息通信
常见问题
集成相关
质量相关
实时对话式 AI
进阶功能
API 参考
对话式 AI FAQ
硬件对话智能体
实时信令
互动白板
客户端 API 参考
Open API 参考
即时通讯 IM
快速开始
客户端 API 参考
服务端 API 参考
服务端 OpenAPI
成员相关
会话成员管理
会话相关
消息相关
用户相关
关于产品
- 文档首页 /实时音视频/实时音视频/服务端 API 参考/服务端回调/回调格式参考
回调格式参考
最近更新时间：2025.11.25 15:46:48首次发布时间：2021.09.27 11:20:13
复制全文
我的收藏有用
有用
无用
无用
文档反馈
问问助手开通消息通知服务，并且订阅的事件发生后，你指定的 URL 会收到来自 RTC 服务端的消息回调。相关事件的信息包含在回调字段中。
回调行为
当你设置关注的回调事件发生时，RTC 服务端会向你指定接收回调的 URL 地址发起 HTTP POST 请求。具体回调信息包含在 Request Body 中。
说明
接收回调的 URL 还必须满足以下条件：
- URL 必须以域名开头。如果 URL 为 HTTPS 域名，请确保该域名 SSL 证书合法且完整。
- URL 支持 GET 请求。添加回调时，服务端会先对该 URL 发起一次 GET 请求以检测其可用性。如果 接收回调的 URL 不支持 GET 请求将返回错误。
回调字段
Request body 中以 JSON 格式包含回调信息，具体字段如下：
- 关于目前支持消息回调的事件（
EventType）和对应的事件内容 (EventData)，参看 消息事件参考。- 当前不保证回调事件的唯一性。建议你可以使用
EventId对事件回调进行去重。- 当前不保证回调消息严格按照事件发生的先后顺序到达您的服务器。您可以通过
EventTime在您的服务端排序处理。
| 参数名 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| EventType | String | RecordStarted | 事件类型 |
| EventData | String | / | 具体的事件内容，格式为 Json |
| EventTime | String | 1970-07-01T00:00:00Z | 事件产生时间，日期格式遵守 ISO-8601 标准。 |
| EventId | String | / | 事件 ID，具有唯一性，可用于去重 |
| AppId | String | Your_AppId | RTC 应用的唯一标识 |
| Version | String | 2020-12-01 | 事件的版本号 |
| Signature | String | / | 回调签名。 |
| Nonce | String | / | 签名随机数 4位 |