事件推送机制

当有事件发生时，伯索平台会向开发者服务器地址推送消息（见接入指南）

商户处理成功时需返回成功标识{"code":0}（"application/json;charset=utf-8"）。

未接收到成功标识或者超时（超时时间5s）时，推送会进行重试。重试时间一次间隔增加，一共3次。

建议开发者根据业务场景进行一定的去重操作。

配置

请联系伯索商务对接同事，完成具体回调地址的配置流程。
配置参数： liveEventCallBackUrl

📌

接口参数格式约束

伯索的回调数据使用Json格式，包装在Post Body中以Post方式发送, HTTP头的Content-Type值为"application/json;charset=utf-8"

商户处理成功时需返回成功标识 {"code":0, "msg":""} Content-Type值为"application/json;charset=utf-8"

事件列表说明

事件类型	事件代码（eventType）	同步时机	说明
统计数据	report	课后	课堂及学员基本统计数据
课堂出勤上下台	attendance	课中	每个学员进出课堂消息
课堂缺勤	absence	课中	课堂开始后缺勤人员数据
课堂一键召回	recall	课中

回调数据格式说明

💡

安全签名信息：
appId : 在申请接入时，伯索平台给予的appId
validBegin: 发送方发送请求时的Unix Epoch 时间戳，单位秒
validTime: 取固定值1200，单位秒
eventInfo: 消息主体内容。字符串类型
signature: 按照签名加密提供的方法返回的签名字符串

参考样例

{
    "appId": "w",
    "eventInfo": "{\"eventType\":\"absence\",\"meetingId\":26226256,\"events\":{\"teacherId\":\"0_30389575\",\"users\":[{\"assistantIds\":[],\"students\":[{\"userId\":\"1_32663337\",\"attendStatus\":2},{\"userId\":\"1_32663341\",\"attendStatus\":2}]}]}}",
    "signature": "56D0480FECD9E2AAE4DC5CBF18CFB26547D83200",
    "validBegin": 1778832721,
    "validTime": 60
}

eventInfo 本质上是一个Json字符串，参与请求体参数统一的签名计算signature

事件推送流程

事件推送机制

事件推送机制#

事件推送机制