伯索云SDK的各个功能调用时间往往很长,比如一堂实时在线课,从创建到课堂结束往往十几分钟到数小时不等,课堂结束后的关键性的返回数据通过异步方式回调返回是最佳方案。回调接口是一个URL地址,通过HTTP/HTTPS协议访问,强烈建议使用HTTPS以增强安全性。 在回调接口开始开发前就可以约定好接口的URL发给伯索对接人进行配置。联系伯索业务人员 完成配置。
配置参数: liveAttendDataCallBackUrl
HTTP头的状态码为200
HTTP头的Content-Type值为"application/json;charset=utf-8"异常返回
HTTP头的状态码为200
HTTP头的Content-Type值为"application/json;charset=utf-8"
HTTP消息体为json对象,格式为:{"code":404, "msg":"error reason"}
2.
回调消息的返回结果如果不符合预期,比如HTTP头状态码为400,503等,将自动在24小时内以不断递增的时间间隔重试5次。 5次发送回调都不成功,回调将不再重试。
3.
伯索的回调数据使用Json格式,包装在Post Body中以Post方式发送, HTTP头的Content-Type值为"application/json;charset=utf-8"
安全签名信息:
appId : 在申请接入时,伯索平台给予的appId
validBegin: 发送方发送请求时的Unix Epoch 时间戳,单位秒
validTime: 取固定值1200,单位秒
signature: 按照 签名加密 提供的方法返回的签名字符串
忽略安全签名信息,直接处理业务字段,也可以跑通业务流程。但是由于回调接口是暴露在公网上,为了防止欺诈攻击,在此强烈建议第三方的回调接口,对signature字段的签名进行强制认证:凡是签名不正确,或者当前 Unix Epoch 时间已超出validBegin + validTime有效期,都认为非法,返回400。
课堂开始后,有成员加入课堂。会触发出勤数据的回调。meetingId: int类型,课堂ID (api接口新建课堂会返回)
data: 课堂出勤数据JSON字符串;
data信息格式:
[
{
"eventTime": int类型 时间时间戳,
"eventType": int类型 事件类型 1:进入 2:离开,
"userId": 字符串类型,学生/老师的用户Id值
}
]
{
"data":[
{"eventTime":1776652479340,"eventType":1,"userId":"0_19035"}
],
"meetingId":26225342
}