伯索开放平台
首页API文档SDK文档
伯索官网
首页API文档SDK文档
伯索官网
  1. SDK文档
  • 历史课堂数据回调接入
  • 签名示例
  • 历史课堂转视频接入方式
  • 历史课堂/微课下载接口
  • query参数说明
  • 文档解析接口
  • SDK预解析服务接入说明
  • 「伯索云学堂」跳转接入指南
  • SDK版本发布记录
  • 课堂出勤上下台数据回调接入(待开发)
  • Web SDK
    • PlasoStyleUpime API说明
    • 云盘接入
    • 接入预解析能力 (Web端)
    • 直播SDK
      • 快速接入
    • 微课SDK
      • 快速接入
    • 批注SDK
      • 快速接入
  • Electron SDK
    • 快速接入
  • Android SDK
    • 直播SDK
      • 快速接入
    • 微课SDK
      • 快速接入
    • 批注SDK
      • 快速接入
  • iOS SDK
    • 直播SDK
      • 快速接入
    • 微课SDK
      • 快速接入
    • 批注SDK
      • 快速接入
  • 播放器SDK
    • Web播放器
  1. SDK文档

课堂出勤上下台数据回调接入(待开发)

伯索云SDK的各个功能调用时间往往很长,比如一堂实时在线课,从创建到课堂结束往往十几分钟到数小时不等,课堂结束后的关键性的返回数据通过异步方式回调返回是最佳方案。
回调接口是一个URL地址,通过HTTP/HTTPS协议访问,强烈建议使用HTTPS以增强安全性。 在回调接口开始开发前就可以约定好接口的URL发给伯索对接人进行配置。
联系伯索业务人员 完成配置。
 配置参数: liveAttendDataCallBackUrl
回调接口的返回结果请务必遵守以下约定:
正常返回
HTTP头的状态码为200
HTTP头的Content-Type值为"application/json;charset=utf-8"
HTTP消息体为json对象,标准格式为
{"code":0, "msg":""}
异常返回
HTTP头的状态码为200
HTTP头的Content-Type值为"application/json;charset=utf-8"
HTTP消息体为json对象,格式为:
{"code":404, "msg":"error reason"}
msg填入异常原因
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。
课堂开始后,有成员加入课堂。会触发出勤数据的回调。
1.
回调报文格式说明
meetingId: int类型,课堂ID (api接口新建课堂会返回)
data: 课堂出勤数据JSON字符串;
2.
data参数解析说明
data信息格式:
[
  {
      "eventTime": int类型 时间时间戳,
      "eventType": int类型  事件类型 1:进入 2:离开,
      "userId": 字符串类型,学生/老师的用户Id值
  }
]
参考样例:
 {
     "data":[
         {"eventTime":1776652479340,"eventType":1,"userId":"0_19035"}
      ],
     "meetingId":26225342
 }
修改于 2026-04-20 03:10:48
上一页
SDK版本发布记录
下一页
PlasoStyleUpime API说明
Built with