回调格式参考--实时音视频-火山引擎

文档中心

立即注册

实时音视频

请输入

服务端回调

回调格式参考

开通消息通知服务，并且订阅的事件发生后，你指定的 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位

最近更新时间：2025.11.25 15:46:48

这个页面对您有帮助吗？

有用

无用