修改课节信息

修改课节信息,需要提供 SID,safekey,timeStamp,课程 ID,课节名称,上下课时间,老师账号,老师姓名,云盘目录 ID,录课,直播,回放,助教、老师UID、助教UID等。其中 SID、safeKey、ttimeStamp、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 通过 sdk管理后台 申请机构认证可获得
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 支持传多个不重复的文件夹ID(最多10个);多个文件夹ID之间用英文逗号分隔,例如"12,13,15";如果多个文件夹ID有重复,返回100错误码;修改之后会覆盖原来的云盘目录信息
record 默认为 0 ,所有非 1 的数字,都会当成 0 处理 录课(0 关闭,1 开启)
live 默认为 0 ,所有非 1 的数字,都会当成 0 处理 直播(0 关闭,1 开启)
replay 默认为 0 ,所有非 1 的数字,都会当成 0 处理 回放(0 关闭,1 开启)
assistantUid 助教 UID 注册用户接口返回的用户 UID
isAutoOnstage 0=自动,1=不自动,可不填,不填则不修改,所有非1的数字,都会当成0处理 学生进入教室时是否自动上台
classIntroduce 0-1000字,不区分中英文,超过1000会自动截取为1000字 课节简介
teachMode 不传不修改,传了则会检查传的值是否正确,不正确报100错误 教学模式,1=在线教室,2=智慧教室 此参数与教室的屏幕模式、摄像头区域、是否自动上台有绑定关系;课节的teachMode=2时,用户传递的isAutoOnstage可能会失效(用户传isAutoOnstage=2会失效)。修改teachMode失败时,返回880错误,880=修改课节教学模式失败注意:4.0版本的客户端才支持

响应参数

参数名 类型 示例值 含义
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.classin-sdk.com
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
  • 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 "live=1" \
     -d "replay=1" \
     -d "assistantUid=1001002" \
     "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 表示开课时间至少一分钟以后
124 表示开课前一分钟内不能更改上课时间
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 表示助教账号格式不正确
350 表示开课前20分钟内不能修改课节名称、上课时间、云盘资源、台上人数
369 该课程/课节类型暂不支持该操作
372 表示修改自动上台失败
385 已过课节结束时间,不能修改授课教师
387 表示老师已被停用
388 表示助教已被停用
400 表示请求数据不合法
800 表示老师被停用中
804 表示助教被停用中
825 表示课节编辑成功,课节简介设置失败
856 表示部分文件夹不存在或不属于本机构
880 修改课节教学模式失败
890 表示课节绑定文件夹个数超出限制

results matching ""

    No results matching ""