You need to enable JavaScript to run this app.
导航
企业直播
  • 文档首页
    • /企业直播/API 参考/直播消息回调/直播间创建或删除回调
直播间创建或删除回调
最近更新时间：2025.08.01 16:30:18首次发布时间：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 次。

参数

参数

类型

说明

ActivityID

String

直播间 ID。

EventType

String

回调通知的事件类型，固定取值 ActivityModifyCallBack。

Timestamp

String

发送回调请求的时间。Unix 时间戳，单位为秒。

Type

String

回调类型。取值如下：

  • 1：创建
  • 2：删除

Sign

String

校验签名。
完成以下步骤，计算校验签名。

  1. 按照 AccountSecret、ActivityID、EventType、Timestamp、Type 的顺序，拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

说明

AccountSecret 的取值可通过控制台获取。详见步骤二：获取鉴权密钥。

RequestUuid

String

请求回调的唯一标识。

ActivityTags

String

直播间配置的标签信息。具体标签信息详见 ActivityTags。

SubAccountName

String

创建直播间的账号。参数值 admin@bytedance.com 表示直播间为主账号创建。

ActivityTags

参数

类型

描述

SelectTags

Array of ActivityTag

直播间分类标签信息列表。

TextTags

Array of ActivityTag

直播间文本标签信息列表。

ActivityTag

参数

类型

描述

Index

Int

标签的索引值，从 0 开始计数。用于标识标签在控制台展示的位置。

Name

String

标签名称。

Value

String

标签值。

TagType

Int

标签类型。取值如下：

  • 0：分类标签
  • 1：文本标签