直播间创建或删除回调--企业直播-火山引擎

文档中心

导航

直播间创建或删除回调

最近更新时间：2025.01.22 11:37:22首次发布时间：2022.11.14 11:41:36

作用

当直播间被创建或删除时，企业直播会对所设置的接口地址进行回调通知。

将接收回调通知的接口地址提供给企业直播技术支持。

设置回调的接口地址后，当直播间被创建或删除时，企业直播系统会将直播间 ID 以及回调类型等信息以 GET 方式提交给您自定义的回调接口地址。
请求示例如下所示：

http://abc.com/test.do?ActivityID=123&EventType=ActivityModifyCallBack&Type=1&Timestamp=1582518318&Sign=xxxx

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

注意

请联系技术支持获取鉴权 AccountSecret。

参数	类型	说明
ActivityID	String	直播间 ID。
EventType	String	回调通知的事件类型，固定取值 `ActivityModifyCallBack`。
Timestamp	String	发送回调请求的时间。Unix 时间戳，单位为秒。
Type	String	回调类型。取值如下： `1`：创建 `2`：删除
Sign	String	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`ActivityID`、`EventType`、`Timestamp`、`Type` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。
RequestUuid	String	请求回调的唯一标识。
ActivityTags	String	直播间配置的标签信息。具体标签信息详见 ActivityTags。
SubAccountName	String	创建直播间的账号。参数值 `admin@bytedance.com` 表示直播间为主账号创建。

参数	类型	描述
SelectTags	Array of ActivityTag	直播间分类标签信息列表。
TextTags	Array of ActivityTag	直播间文本标签信息列表。

参数	类型	描述
Index	Int	标签的索引值，从 0 开始计数。用于标识标签在控制台展示的位置。
Name	String	标签名称。
Value	String	标签值。
TagType	Int	标签类型。取值如下： `0`：分类标签 `1`：文本标签