获取课程直播/回放播放器地址

  我们为您提供了一个多平台支持的播放器页面,可以根据本接口获得的链接来观看在 ClassIn 上录的课。根据课程 ID 和课节 ID 来获取直播、回放的播放器地址。注:课程或者课节的链接地址是固定不变的,无须重复获取。

    小贴士: 针对 iOS 11+ 可能存在 cookie 写入不进去的情况
    但仍想用 iframe 嵌套直播页面,可以在 H5 页面头部,所有js之前引入
    <script src="//www.eeo.cn/js/live/eeolive_fix.js"></script>

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

登陆聊天

机构直播聊天室免二次登录

  • 当您通过本接口获得播放器链接之后
    • 例:https://www.eeo.cn/webcast.php?courseKey=xxx&lessonid=xxx
    • 从直播器地址中可以获得 courseKey、lessonid
    • 您需要增加 account、nickname、checkCode 拼接在 https://live.eeo.cn/webcast_partner.html 地址后边,注意:这个免二次登录地址与直播播放器地址不是同一个地址
  • 具体参数及规则如下
    • 具体参数有 courseKey、lessonid、account、nickname、checkCode
    • 其中 lessonid 为可选,其他参数皆为必选
    • account 为学生账号(长度小于32个字符),nickname 为学生昵称(长度小于24个字符)
    • checkCode = md5(secret+courseKey+account+nickname)
    • secret 为SECRET,在 EEO.cn API 对接密钥处可获得
  • URL 拼接示例
    • https://live.eeo.cn/webcast_partner.html?courseKey=7be856f28907f1a2&lessonid=123456&account=18600123456&nickname=eeo&checkCode=febe50cd50ba4d3af506bfa118a3845b

URL

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

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

响应参数

参数名 类型 示例值 含义
data string https://www.eeo.cn/webcast.php?courseKey=xxx&lessonid=xxx 返回直播回放页面地址
error_info object 返回信息对象
└ errno number 1 错误代码
└ error string "程序正常执行" 错误详情

示例

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

SID=2339736&safeKey=c23f15a4382fd1da7e91a9697955b9bf&timeStamp=1493901829&courseId=536317&classId=1432593
  • Shell cURL 模拟请求指令
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
        -d "SID=1234567" \
        -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
        -d "timeStamp=1484719085" \
        -d "courseId=123456" \
        -d "classId=9876" \
    "https://root_url/partner/api/course.api.php?action=getWebcastUrl"

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

{
  "data": "https://www.eeo.cn/webcast.php?courseKey=4fe1167f8060e809&lessonid=123456",
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

错误码说明

错误码 说明
1 表示成功执行
100 表示参数不全或错误
102 表示无权限(安全验证没通过)
142 表示该课程下无此课节信息
143 表示没有此课节信息
144 表示机构下无此课程
149 表示课程已删除
212 表示该课节已经删除
369 该课程/课节类型暂不支持该操作

results matching ""

    No results matching ""