修改课节信息

修改课节信息,需要提供 SID,safekey,timeStamp,课程 ID,课节名称,上下课时间,老师账号,老师姓名,云盘目录 ID,录课,直播,回放,联席教师、教学模式,是否自动上台,老师UID、联席教师UID、网页直播回放、允许未登录用户参与直播聊天和点赞等。其中 SID、safeKey、timeStamp、courseId、classId为必填项,其他参数需要修改那个就填写那个(修改录课、直播、回放三个参数任意一个,其他两个参数则必填。否则不生效)。修改录制现场时,录课、直播和回放三个参数必填。返回执行后的成功说明,修改上台人数需要调用 修改课节上台学生数

注意事项:

  • 开课前20分钟内不能修改课节名称、上课时间、云盘资源、台上人数、是否自动上台、教学模式。
  • 如果上课中修改课节老师,则正在上课的老师会退出教室。
  • 如果课节设置录课(没有设置直播),则more_data返回课节直播播放器地址,拉流地址为空。
  • 如果课节设置录课、直播,则more_data返回课节直播播放器地址和拉流地址。
  • 如果编辑或者设置其他参数,没有改变录课/直播/回访任何参数,则按照创建时返回more_data。
  • 开课前如已设置联席教师,开课后可更换或删除联席教师;开课前如未设置联席教师,开课后可添加联席教师。
  • 编辑课节更多参数规则可参考 参数规则

URL

https://root_url/partner/api/course.api.php?action=editCourseClass

HTTP Request Methods

  • POST

编码格式

  • UTF-8

请求参数

key 必填 更多限制 说明 规则说明
SID 机构认证 ID 通过 eeo.cn 申请机构认证可获得
safeKey 固定 32 位全小写字符 机构认证安全密钥 safeKey=MD5(SECRET+timeStamp)
timeStamp 当前调用接口20分钟以内的 Unix Epoch 时间戳 Unix Epoch 时间戳是 1970年1月1日 00:00:00 (世界标准时间) 起经过的秒数
courseId 课程 ID
classId 课节 ID
className 1-50个字,不区分中英文,超过会自动截取为50字 课节名称
beginTime 开课时间须在3年以内 上课时间 Unix Epoch 时间戳(秒单位)
endTime 若填写了 beginTime,则必须填写 endTime 下课时间 Unix Epoch 时间戳(秒单位)
teacherUid 教师 UID 注册用户接口返回的用户 UID
folderId 不传默认为课程授权云盘ID 云盘目录 ID
record 默认为 0 ,所有非 1 的数字,都会当成 0 处理 录课(0 关闭,1 开启)
recordScene 默认为 0 ,所有非 1 的数字,都会当成 0 处理 录制现场(0 关闭,1 开启)
live 默认为 0 ,所有非 1 的数字,都会当成 0 处理 直播(0 关闭,1 开启)
replay 默认为 0 ,所有非 1 的数字,都会当成 0 处理 回放(0 关闭,1 开启)
assistantUid 与assistantUids参数不能同时传。此参数传空时为删除助教。 联席教师 UID 注册用户接口返回的用户 UID
assistantUids 与assistantUid 参数不能同时传。此参数为整型数组,如果传空数组为删除助教。 联席教师 UID 数组[1001002,1001003] 注册用户接口返回的用户 UID
teachMode 不传不修改,传了则会检查传的值是否正确,不正确报100错误 教学模式,1=在线教室,2=智慧教室 当teachMode=2时,isAutoOnstage会始终被设置为1(也就是说,teachMode=2时,API会忽略传参isAutoOnstage的值)
isAutoOnstage 0=自动,1=不自动,可不填,不填则不修改,所有非1的数字,都会当成0处理 学生进入教室时是否自动上台
classIntroduce 0-1000字,不区分中英文,超过1000会自动截取为1000字 课节简介
watchByLogin 不传或传错,都不修改 只允许登录ClassIn账号后才可观看,未登录不可观看,0=未开启,1=开启 未开启录课、直播、回放中的两项及以上,此参数设置了也用不到
allowUnloggedChat 不传或传错,都不修改 允许未登录用户参与直播聊天和点赞,0=不允许,1=允许 未开启录课和直播,此参数设置了也用不到

响应参数

参数名 类型 示例值 含义
more_data array [] 返回 Data 信息数组
 └ live_url string https://www.eeo.cn/live.php?lessonKey=0fdc12bc3558164d 课节直播播放器地址
 └ live_info array [] 返回 Data 信息数组
  └ RTMP string "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" 直播拉流地址
  └ HLS string "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" 直播拉流地址
  └ FLV string "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" 直播拉流地址
error_info object 返回信息对象
└ errno number 1 错误代码
└ error string "程序正常执行" 错误详情

示例

  • HTTP 请求
POST /partner/api/course.api.php?action=editCourseClass HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=58ce17711abea665f40f67d550ce96fb&timeStamp=1493364941&courseId=490583&classId=1395039&className=chinese&beginTime=1493434330&endTime=1493444330&teacherUid=1001001&folderId=&record=1&live=1&replay=1&watchByLogin=0&allowUnloggedChat=1
  • Shell cURL 模拟请求指令
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
     -d "SID=1234567" \
     -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
     -d "timeStamp=1484719085" \
     -d "courseId=442447" \
     -d "classId=23644"  \
     -d "className=测试课程" \
     -d "beginTime=1484739085" \
     -d "endTime=1484739085" \
     -d "teacherUid=1001001" \
     -d "folderId=1" \
     -d "record=1" \
     -d "recordScene=1" \
     -d "live=1" \
     -d "replay=1" \
     -d "assistantUids=[1001002,1001003]" \
     -d "watchByLogin=0" \
     -d "allowUnloggedChat=1" \
     "https://root_url/partner/api/course.api.php?action=editCourseClass"

响应示例(正常时返回的 json 数据包示例)

{
  "more_data": {
        "live_url": "https://www.eeo.cn/live.php?lessonKey=0fdc12bc3558164d",
        "live_info": {
            "RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
            "HLS": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
            "FLV": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
        }
    },
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

错误码说明

错误码 说明
1 表示成功执行
100 表示参数不全或错误
102 表示无权限(安全验证没通过)
104 表示操作失败(未知错误)
114 表示服务器异常
119 表示结束时间须晚于开课时间
120 表示开课时间至少一分钟以后
136 表示机构下面没有该老师,请在机构下添加该老师
140 表示该课节正在上课,不能编辑和删除
142 表示该课程下无此课节信息
143 表示无此课节信息
144 表示机构下无此课程
145 表示该课节已经结束
160 表示机构下无此云盘目录
165 表示单节课不能少于15分钟且不能超过24小时
172 表示课程下的学生不能添加为老师
173 表示课程下的旁听不能添加为老师
212 表示该课节已经删除
268 表示课节开始时间超出允许范围(开课时间须在3年以内)
282 表示课节修改成功,录课参数设置错误,录课修改失败
283 表示课节修改成功,开课前20分钟内不能开启录课,录课修改失败
284 表示课节修改成功,视频服务有问题,录课修改失败
318 表示联席教师不是本机构老师
319 表示课程下的学生不能添加为联席教师
320 表示课程下的旁听不能添加为联席教师
321 表示插班生不能添加为联席教师
322 表示课节老师不能添加为联席教师
323 表示联席教师购买课节失败
324 表示课节老师加入教师列表失败
325 表示插班生不能添加为老师
326 表示课节联席教师加入教师列表失败
327 表示联席教师退订课节失败
328 表示课节联席教师不能添加为老师
330 表示联席教师账号格式不正确(2022年4月去除此错误码)
350 表示开课前20分钟内不能修改课节名称、上课时间、云盘资源、台上人数、是否自动上台、教学模式
369 该课程/课节类型暂不支持该操作
372 表示修改自动上台失败
385 已过课节结束时间,不能修改授课教师或联席教师
387 表示老师已被停用
388 表示联席教师已被停用
400 表示请求数据不合法
454 课节起止时间与系统维护时间有重叠
466 表示通过客户端-创建课堂产生的课节只能在客户端编辑(接口不支持编辑lms课节)
800 表示老师被停用中
804 表示联席教师被停用中
825 表示课节编辑成功,课节简介设置失败
880 表示修改课节教学模式失败
884 老师帐号已注销
885 联席教师帐号已注销
21316 联席教师数据有重复
21317 联席教师数量超出限制
121601001 存在当前版本不支持的设置项
121601002 操作成功,[在线教室]资源已超出用量,为防止业务受影响,请尽快联系客户经理
121601003 您当月累计创建课节已达当月上限,无法继续创建,升级账号获取更多权益
121601004 您当月累计创建课节已达当月上限,无法继续创建
121601005 不支持设网页直播
121601006 不支持设置录制现场
121601007 台上人数参数错误
121601008 不支持设置联席教师
121601009 不支持设置网页回放
121601010 不支持设置录课
121601011 不支持设置双摄模式
121601012 清晰度超出限制

results matching ""

    No results matching ""