提供上下课确认接口
直播云老师端点击上下课按钮,需要通知第三方机构,并且第三方机构确认后要返回固定的数据格式给直播云。
要求如下:
地址
****/lesson/notice(由需要SDK对接的机构提供)
请求方式
POST - form提交
请求参数
参数名称 | 是否必填 | 参数含义 |
---|---|---|
status | 是 | 课程状态 2上课 3下课 |
lesson_id | 是 | 第三方课程id |
user_id | 否 | 第三方用户id |
返回值
成功返回值
返回格式为JSON(Content-Type为application/json),JSON示例加说明
所有参数必需,注意true/false要加""{
"status": "true",
"actual_time": "2020-12-20 20:00:00",//真实上课时间
"server_time": "2017-01-01 00:12:14",//服务器当前时间
"data": "******"//机构自定义即可
"msg":"succ"
}
失败返回值
返回格式为JSON,JSON示例加说明
{
"status": "false",
"actual_time": "2020-12-20 20:00:00",//真实上课时间
"server_time": "2017-01-01 00:12:14",//服务器当前时间
"data": "******"//机构自定义即可
"msg":"调用失败"
}
判断返回值:status为"false"时,通知上下课失败,返回"true"时,通知上下课成功, actual_time server_time必须要有
注意事项
老师上课过程中退出教室后,再进入教室会再次调用该接口,所以第三方机构需要记录课程状态和actual_time,如果已经上课,再调用该接口传入上课状态为1,actual_time不应该变化,还是保持之前的值。因为server_time - actual_time就是已经开课的时间。