| 回调 | 什么时候到 | 用来做什么 |
|---|---|---|
| 课堂延时/提前结束回调 | 老师延时课堂,或老师提前结束课堂 | 把新的结束时间同步到客户业务系统 |
| 课堂出勤回调 | 本段课堂第一次开始录制后,再等待伯索人员配置的出勤回调时间 | 推送当时已进入课堂的人员名单 |
| 字段 | 类型 | 说明 |
|---|---|---|
liveStatusCallBackUrl | string | 课堂延时/提前结束回调地址。未配置则不推送 |
orgArrivalAddr | string | 课堂出勤回调地址。空字符串不推送 |
orgDelay | number | 课堂出勤回调的等待时长,单位毫秒。由伯索人员按机构设置,客户不能在进房参数里指定。0 表示录制一开始就推送。例如 600000 表示 10 分钟 |
liveStatusCallBackUrl。课堂服务在老师延时课堂或老师提前结束课堂时调用该地址。| 场 景 | 是否回调 | newEndTime |
|---|---|---|
| 老师延时课堂 | 是 | 有。新的结束时间,Unix 毫秒时间戳,JSON 里是字符串 |
| 老师提前结束课堂 | 是 | 无。请求体里不出现该字段 |
| 到达预定结束时间自动下课 | 否 | — |
appId 为伯索内部机构 | 否 | 走内部排课,不回调客户地址 |
| 约定 | 说明 |
|---|---|
| 方法 | POST |
Content-Type | application/json |
| 超时 | 3 秒 |
| 重试 | 失败只记日志,不重试 |
| 成功判定 | HTTP 2xx。响应体不参与判定 |
id + opTime 做幂等。漏一次回调时,以客户自己的排课结束时间为准。| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
appId | string | 是 | 机构 appId |
id | string | 是 | 课堂 ID,即进房时的 meetingId |
opTime | string | 是 | 本次操作时间,Unix 毫秒时间戳 |
newEndTime | string | 延时课堂时有 | 新的课堂结束时间,Unix 毫秒时间戳。提前结束课堂时没有此字段 |
validBegin | number | 是 | 签名生效时间,Unix 秒 |
beginTime | number | 是 | 与 validBegin 相同,Unix 秒。它不是课堂开始时间 |
validTime | number | 是 | 固定 300,单位秒 |
signature | string | 是 | 用机构 signKey 做 HMAC-SHA1,40 位大写十六进制 |
signature,跳过未出现的字段,参数名按 UTF-8 字节升序,拼成 key=value&key=value,用 signKey 做 HMAC-SHA1,输出大写十六进制。数字按十进制原文参与计算,不要加引号,也不要做 URL 编码。demoSignKey):appId=demo&beginTime=1763395200&id=20261117001&newEndTime=1763398800000&opTime=1763395300123&validBegin=1763395200&validTime=300newEndTime:appId=demo&beginTime=1763396400&id=20261117001&opTime=1763396400456&validBegin=1763396400&validTime=300{
"appId": "demo",
"validBegin": 1763395200,
"beginTime": 1763395200,
"validTime": 300,
"newEndTime": "1763398800000",
"opTime": "1763395300123",
"id": "20261117001",
"signature": "DC2CA2A2AC288790AE503DF5E8323BA2B5EF9958"
}{
"appId": "demo",
"validBegin": 1763396400,
"beginTime": 1763396400,
"validTime": 300,
"opTime": "1763396400456",
"id": "20261117001",
"signature": "2422740002EA46D620619AA8752A332F9F29A24F"
}meetingId 的结束时间更新为 newEndTime。收到没有 newEndTime 的报文后,把课堂标记为老师已提前结束,结束时间取 opTime。同一 id + opTime 重复到达时只更新一次。orgArrivalAddr。推送时机不由客户在进房参数里指定。录制开始后等待多久,由伯索人员在机构配置里设置延时时间。需要开通或调整这个等待时长时,联系伯索对接同事。未配置 orgArrivalAddr 则不会推送。orgDelay 毫秒。0 表示录制一开始就推送。meetingId 归属和来源网络做校验。不要把这个接口做成可被任意公网调用的写接口。| 字段 | 类型 | 说明 |
|---|---|---|
meetingId | string | 客户侧课堂 ID |
recordId | string | 本段录制 ID。一堂课中断后可能产生多段 |
statistics | array | 延迟时刻已经进入过课堂的成员 |
statistics 每个元素:| 字段 | 类型 | 说明 |
|---|---|---|
loginName | string | 进房时的用户 ID |
userName | string | 显示名 |
roleType | string | 角色,见下表 |
joinClassTime | number | 第一次进入本段课堂的时间,Unix 毫秒 |
roleType 常见取值:| 值 | 角色 |
|---|---|
speaker | 主讲 |
assistant | 助教 |
listener | 学生 |
visitor | 访客 |
monitor | 监课 |
600000 时,录制开始 10 分钟后推送:{
"meetingId": "20261117001",
"recordId": "6740a1b2c3d4e5f678901234",
"statistics": [
{
"loginName": "t1",
"userName": "老师1",
"roleType": "speaker",
"joinClassTime": 1763391000123
},
{
"loginName": "s1",
"userName": "学生1",
"roleType": "listener",
"joinClassTime": 1763391060456
}
]
}meetingId + recordId 幂等保存。重复报文覆盖同一条出勤记录,不要重复开课、重复计费。/class-end-time,课堂出勤回调指向 /arrival。密钥只放在服务端。appId=demo&beginTime=1763395200&id=20261117001&newEndTime=1763398800000&opTime=1763395300123&validBegin=1763395200&validTime=300
DC2CA2A2AC288790AE503DF5E8323BA2B5EF9958orgDelay,确认三条报文的字段和签名与本文一致。