创建课节(单个)

创建课节，创建单个课节，需要提供 SID，safekey，timeStamp，课程 ID，课节名称，上课时间，下课时间，老师账号，老师姓名，云盘目录 ID，学生上台人数和录播等各部分详情，助教，是否上台，是否高清、唯一标识、课节简介、老师UID、助教UID。其中 SID、safeKey、timeStamp、courseId、className、beginTime、endTime、teacherUid 为必填项。返回创建成功后的课节 ID 和执行后的说明。注意：因为目前仅支持 1v1 或者 1v6 高清、全高清，所以选择高清时上台人数只能选择 1 或者 6 。 机构传入唯一标识后，该接口会校验机构下所有已创建课节中是否有此唯一标识，如果有，则返回之前创建成功的课节 ID。如果没有，则正常执行。 机构传入唯一标识后，该接口会校验机构下所有已创建课节中是否有此唯一标识，如果有，则返回之前创建成功的课节 ID。如果没有，则正常执行。

注意事项：

• 如果课节设置录课（没有设置直播），则more_data返回 课节直播播放器地址 ，拉流地址为空；
• 如果课节设置录播、直播，则会给该课节绑定三个拉流地址（RTMP，HLS 和 FLV），more_data返回课节直播播放器地址和拉流地址（不论该课节后续是否取消直播，这三个地址仍然存在且与该课节绑定）；
• 当课节没有设置录课，则more_data里的课节直播播放器地址和拉流地址均为空。

附拉流地址优缺点对比，以下对比仅供参考。

在返回的课节直播播放器页面我们植入了聊天室功能。为了方便您搜集潜在客户信息，所有用户需要填写手机号登陆后才可以聊天，如下图。当然，为了您更便捷的使用此功能，我们提供了您机构下所有学生免登陆的操作，请参考下方的 直播播放器中聊天室免二次登录。

直播播放器中聊天室免二次登录

• 当您通过本接口获得播放器链接之后
  • 例：https://www.eeo.cn/live.php?lessonKey=1ca102d29e61175f
  • 您需要增加 account、nickname、checkCode 拼接在 https://www.eeo.cn/live_partner.php?lessonKey=00d1c98a91c52568 地址后边。 注意：这个免二次登录地址与直播播放器地址不是同一个地址
• 具体参数及规则如下
  • 具体参数有 secret、lessonKey、account、nickname、checkCode
  • secret 为SECRET，在 sdk管理后台 API 对接密钥处可获得
  • 从直播器地址中可以获得 lessonKey
  • account 为学生账号，nickname 为学生昵称
  • checkCode = md5(secret+lessonKey+account+nickname)
• URL 拼接示例
  • https://www.eeo.cn/live_partner.php?lessonKey=00d1c98a91c52568&account=13700000000&nickname=classin&checkCode=d8c57caf088529b4ddd15b0f694d847b

URL

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

HTTP Request Methods

• POST

编码格式

• UTF-8

请求参数

响应参数

示例

• HTTP 请求

POST /partner/api/course.api.php?action=addCourseClass HTTP/1.1
Host: www.classin-sdk.com
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=e2f53f7a1b51bc86e52bbd080d8bf0f0&timeStamp=1493350659&courseId=490583&className=Chinese-10&beginTime=1493607694&endTime=1493609694&teacherUid=1001001&folderId=&seatNum=6&record=1&live=0&replay=1&assistantUid=1001002&isAutoOnstage=0&isHd=0&courseUniqueIdentity=54421&classIntroduce=ClassIn,真正的在线教室

• 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 "className=测试课节-1" \
       -d "beginTime=1492506000" \
       -d "endTime=1492507800" \
       -d "teacherUid=1001001" \
       -d "folderId=22418" \
       -d "seatNum=6" \
       -d "record=1" \
       -d "live=1" \
       -d "replay=1" \
       -d "assistantUid=1001002" \
       -d "isAutoOnstage=0" \
       -d "isHd=0" \
       -d "courseUniqueIdentity=4565234" \
       -d "classIntroduce=ClassIn,真正的在线教室" \
       "https://root_url/partner/api/course.api.php?action=addCourseClass"

响应示例（正常时返回的 json 数据包示例）

{
  "data": 23623,
  "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": "程序正常执行"
  }
}

错误码说明