You need to enable JavaScript to run this app.
导航
签到状态变化回调
最近更新时间:2025.11.05 11:00:13首次发布时间:2025.11.05 11:00:13
复制全文
我的收藏
有用
有用
无用
无用

作用

当签到状态发生变化时,包括签到创建、删除、发送、截止或其它状态变化,企业直播会向您设置的回调地址发送回调消息。

配置方式

完成回调配置。详见回调配置

详情

完成回调配置后,当签到状态变化时,企业直播系统会将直播间 ID 以及变化后的签到状态以 POST 方式提交给您设置的回调地址。
请求示例如下所示:

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "EventType": "CheckinStatusModifyCallback",
    "RequestUuid": "ActivityAwardInfoCallBack-182572318444****",
    "Sign": "c7594afe578431086bf1c56eff54****",
    "SubAccountName": "+861803738****",
    "Timestamp": "1817283811",
    "ActivityId": "182573526550****",
    "CheckInId": "checkIn1754478641140736",
    "Status": "Init"
}

超时重试

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

参数

参数

类型

说明

EventType

String

回调通知的事件类型,固定取值 ActivityStatusModifyCallBack

RequestUuid

String

请求回调的唯一标识。

Sign

String

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

  1. 按照 ActivityIdCheckInIdEventTypeStatusTimestamp 的顺序,拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

SubAccountName

String

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

Timestamp

String

观众签到时间。Unix 时间戳,单位为秒。

ActivityID

String

直播间 ID。

CheckInId

String

签到 ID。

Status

String

变化后的签到状态。取值如下:

  • Init: 创建
  • Export: 发送至评论区,用户可参与
  • Deadline: 签到截止
  • Delete: 未发送情况下被删除
  • Retract: 已发送情况下手动撤回