HTTP接口

创建直播间

通过该接口可以创建直播间,接口请求地址为:

http://api.csslcloud.net/api/room/create

需要传递以下参数:

参数 说明 备注
userid CC账户ID
name 直播间名称,最大字符40 标题头尾的空格字符会自动删除
desc 直播间描述,最大字符5000
templatetype 直播模板类型,请求模板信息接口可获得模板类型的详细信息。
authtype 验证方式,0:接口验证,需要填写下面的checkurl;1:密码验证,需要填写下面的playpass;2:免密码验证
publisherpass 推流端密码,即讲师密码
assistantpass 助教端密码
playpass 播放端密码 可选
checkurl 验证地址 可选
barrage 是否开启弹幕。0:不开启;1:开启 可选,默认为0
foreignpublish 是否开启第三方推流。0:不开启;1:开启 可选,默认为0,开启时必须开启网页登录的主持人模式,支持模板类型1、2、3、6
openlowdelaymode 开启直播低延时模式。0:不开启;1:开启 可选,默认为0
openchatmanage 开启聊天审核。0:不开启;1:开启 可选,默认为0
showusercount 在页面显示当前在线人数。0:不显示;1:显示 可选,默认0,不显示当前人数,模板一暂不支持此设置
openhostmode 开启主持人模式,"0"表示不开启;"1"表示开启 可选,默认为0,开通主持人模式权限后方可设置
hostloginmode 主持人登录模式,"0"表示网页登录;"1"表示客户端登录 可选,默认为0,客户端登录只支持模板类型4、5
warmvideoid 插播暖场视频,填写同一账号下云点播视频vid 可选,默认关闭;参数值为空,表示关闭
livestarttime 直播开始时间;格式:yyyy-MM-dd HH:mm:ss 可选,默认为空
playerbackgroundhint 播放器提示语。未直播时播放器将显示该提示语 可选,最多15个字符
manuallyrecordmode 手动录制模式。0:关闭;1:开启 可选,默认关闭
clientdocpermissions 讲师文档权限。0:关闭;1:开启 可选,默认关闭;
repeatedloginsetting 重复登录设置;0:允许后进入者登录;1:禁止后进入者登录,对讲师端和观看端生效 可选,默认0
maxaudiencenum 直播间并发人数上限 可选,默认为0,表示不做限制
documentdisplaymode 文档显示模式。1:适合窗口;2:适合宽度 可选,适合窗口
openlivecountdown 倒计时功能。0:关闭;1:开启 可选,默认关闭
showlectueronlinenum 讲师端显示在线人数。0:不显示;1:显示 可选,默认显示
showassistonlinenum 助教主持人端显示在线人数。0:不显示;1:显示 可选,默认显示
openmarquee 跑马灯功能。0:关闭;1:开启 可选,默认为0
hideexitbutton 隐藏观看端退出按钮。0:不开启;1:开启 可选,默认为0
alarms 直播提醒设置,格式如下:[{"time":"","desc":""},{"time":"","desc":""},{"time":"","desc":""}] time为提醒时间点(单位:分钟),类型为字符串,取值范围1-1000的整数;desc为提醒内容,类型为字符串,最多20个字符 可选,默认为空
openTextPicLive 移动H5页面是否显示图文直播。0:隐藏;1:显示 可选,默认为0 (需开通权限)
inRemindFlag 进入直播是否提醒:1-是;0-否 可选,默认为0
inRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割 可选,默认为1,2,3,4
inBeContent 进入直播提醒内容前段 可选,inBeContent和inAfContent加起来字符限制10个
inAfContent 进入直播提醒内容后段 可选,inBeContent和inAfContent加起来字符限制10个
outRemindFlag 退出直播是否提醒:1-是;0-否 可选,默认为0
outRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割 可选,默认为1,2,3,4
outBeContent 退出直播提醒内容前段 可选,outBeContent和outAfContent加起来字符限制10个
outAfContent 退出直播提醒内容后段 可选,outBeContent和outAfContent加起来字符限制10个
privateChat 私聊开关,1: 开启,0: 关闭 可选,默认1: 开启

返回数据包含如下字段:

字段名 说明
result 请求结果。OK:成功;FAIL:失败
room 直播间信息

room包含如下字段:

字段名 说明
id 直播间id
publishUrls 推流地址,第三方推流的直播间可以获取到此参数

JSON格式的返回信息如下:

 {
    "result": "OK",
    "room": {
      "id": "76620AD36E2F23719C33DC5901307461",
      "publishUrls": [
            "rtmp://xxxx.xxxx.net/live/EE98D675ABF4FEA99C33DC5901307461_0",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_1",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_2"
        ]
    }
  }

编辑直播间

通过该接口可以编辑直播间的信息,接口请求地址为:

http://api.csslcloud.net/api/room/update

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
name 直播间名称,最大字符40 可选,标题头尾的空格字符会自动删除
desc 直播间描述,最大字符5000 可选
templatetype 直播模板类型,请求模板信息接口可获得模板类型的详细信息。 可选
authtype 验证方式,0:接口验证,需要填写下面的checkurl;1:密码验证,需要填写下面的playpass;2:免密码验证 可选
publisherpass 推流端密码,即讲师密码 可选
assistantpass 助教端密码 可选
playpass 播放端密码 可选
checkurl 验证地址 可选
barrage 是否开启弹幕。0:不开启;1:开启 可选
openlowdelaymode 开启直播低延时模式。0为关闭;1为开启 可选
openchatmanage 开启聊天审核。0:不开启;1:开启 可选,默认为0
showusercount 在页面显示当前在线人数,0表示不显示;1表示显示 可选,模板一暂不支持此设置
warmvideoid 插播暖场视频,填写同一账号下云点播视频vid 可选,参数值为空,表示关闭
livestarttime 直播开始时间;格式;yyyy-MM-dd HH:mm:ss 可选
playerbackgroundhint 播放器提示语。未直播时播放器将显示该提示语 可选,最多15个字符
manuallyrecordmode 手动录制模式。0:关闭;1:开启 可选
clientdocpermissions 讲师文档权限。0:关闭;1:开启 可选
repeatedloginsetting 重复登录设置;0:允许后进入者登录;1:禁止后进入者登录,对讲师端和观看端生效 可选
maxaudiencenum 直播间并发人数上限 可选
documentdisplaymode 文档显示模式。1:适合窗口;2:适合宽度 可选
openlivecountdown 开启倒计时功能。0:不开启;1:开启 可选
showlectueronlinenum 讲师端显示在线人数。0:不显示;1:显示 可选
showassistonlinenum 助教主持人端显示在线人数。0:不显示;1:显示 可选
openmarquee 跑马灯功能。0:关闭;1:开启 可选
hideexitbutton 隐藏观看端退出按钮。0:不开启;1:开启 可选,默认为0
alarms 直播提醒设置,格式如下:[{"time":"","desc":""},{"time":"","desc":""},{"time":"","desc":""}] time为提醒时间点(单位:分钟),类型为字符串,取值范围1-1000的整数;desc为提醒内容,类型为字符串,最多20个字符 可选
inRemindFlag 进入直播是否提醒:1-是;0-否 可选,默认为0
inRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割 可选,默认为1,2,3,4
inBeContent 进入直播提醒内容前段 可选,inBeContent和inAfContent加起来字符限制10个
inAfContent 进入直播提醒内容后段 可选,inBeContent和inAfContent加起来字符限制10个
outRemindFlag 退出直播是否提醒:1-是;0-否 可选,默认为0
outRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割 可选,默认为1,2,3,4
outBeContent 退出直播提醒内容前段 可选,outBeContent和outAfContent加起来字符限制10个
outAfContent 退出直播提醒内容后段 可选,outBeContent和outAfContent加起来字符限制10个
openTextPicLive 移动H5页面是否显示图文直播。0:隐藏;1:显示 可选,默认为0 (需开通权限)
privateChat 私聊开关,1: 开启,0: 关闭 可选,默认1: 开启

JSON格式的返回信息如下:

 {
    "result": "OK"
  }

关闭直播间

通过该接口将直播间关闭,接口请求地址为:

http://api.csslcloud.net/api/room/close

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户ID

JSON格式的返回信息如下:

{
      "result": "OK"
  }

备注:如果直播间正在进行直播,将无法关闭,返回错误信息包含:invalid operation

开启直播间

通过该接口将已关闭直播间开启,接口请求地址为:

http://api.csslcloud.net/api/room/open

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户ID

JSON格式的返回信息如下:

{
      "result": "OK"
  }

删除直播间

通过该接口可删除直播间,同时会删除该直播间下全部直播和回放,不可恢复,接口请求地址为:

http://api.csslcloud.net/api/room/delete

需要传递以下参数:

参数 说明
roomids 直播间id,支持多个,id之间以英文逗号","分隔,批量删除数量不能超过100个
userid CC账户ID

JSON格式的返回信息如下:

{
      "result": "OK"
  }

获取直播间列表

通过该接口可以获取用户的直播间列表信息

http://api.csslcloud.net/api/room/info

需要传递以下参数:

参数 说明 备注
userid CC账户ID
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
pageindex 页码
count 直播间总数
rooms 直播间列表信息

rooms包含多个直播间信息,直播间包含以下字段:

字段名 说明
id 直播间id
name 直播间名称
desc 直播间描述
status 直播间状态,10:正常; 20:关闭; 40:已封禁
publisherPass 推流端密码
playPass 播放端密码
assistantPass 助教密码
checkUrl 验证地址
templateType 模板类型
authType 验证类型
barrage 是否开启弹幕,0:不开启;1:开启
publishUrls 推流地址,第三方推流直播间可以获取到此参数
openLowDelayMode 开启低延时模式,"0"表示不开启;"1"表示开启
delayTime 延时时间,单位秒。低延时模式下该值为0.
showUserCount 在页面显示用户在线人数,"0"表示不显示;"1"表示显示
openHostMode 开启主持人模式,"0"表示不开启;"1"表示开启
hostLoginMode 主持人登录模式,"0"表示网页登录;"1"表示客户端登录
foreignPublish 是否开启第三方推流。0:不开启;1:开启
warmVideoId 插播暖场视频,为空,表示关闭
liveStartTime 直播开始时间
playerBackgroundHint 播放器提示语
manuallyRecordMode 手动录制模式。0:关闭;1:开启
clientDocPermissions 讲师文档权限。0:关闭;1:开启
repeatedLoginSetting 重复登录设置;0:允许后进入者登录;1:禁止后进入者登录,对讲师端和观看端生效
maxAudienceNum 直播间并发人数上限
documentDisplayMode 文档显示模式。1:适合窗口;2:适合宽度
openLiveCountdown 开启倒计时功能。0:不开启;1:开启
showLectuerOnlineNum 讲师端显示在线人数。0:不显示;1:显示
showAssistOnlineNum 助教主持人端显示在线人数。0:不显示;1:显示
openMarquee 跑马灯功能。0:关闭;1:开启
openChatManage 聊天审核是否开启。0:不开启;1:开启
hideExitButtonFlag 隐藏观看端退出按钮。0:不开启;1:开启
alarms 直播提醒设置,格式如下:[{"time":"","desc":""},{"time":"","desc":""},{"time":"","desc":""}] time为提醒时间点(单位:分钟),类型为字符串,取值范围1-1000的整数;desc为提醒内容,类型为字符串,最多20个字符

JSON格式的返回信息如下:

{
     "result": "OK",
     "pageIndex": 1,
     "count": 100,
     "rooms": [
         {
             "id": "76620AD36E2F23719C33DC5901307461",
             "name": "直播间名称",
             "desc": "直播间描述",
             "status": 10,
             "publisherPass": "PubToken",
             "playPass": "PlayToken",
             "assistantPass": "assToken",
             "checkUrl": "http://check.xxx.com/api/viewer/check",
             "templateType": 1,
             "authType": 1,
             "barrage": 1,
             "publishUrls": [
            "rtmp://xxxx.xxxx.net/live/EE98D675ABF4FEA99C33DC5901307461_0",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_1",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_2"
        ],
             "openLowDelayMode": "1",
             "delayTime": "0",
             "showUserCount": "1",
             "openHostMode": "0",
             "hostLoginMode": "0",
             "foreignPublish": 0,
             "warmVideoId": "",
             "liveStartTime":"2015-01-02 12:30:01",
             "playerBackgroundHint":"你好",
             "manuallyRecordMode":"0",
             "clientDocPermissions":"0",
             "openMarquee": "0",
             "repeatedLoginSetting":"0",
             "maxAudienceNum":"100",
             "documentDisplayMode":"1",
             "openLiveCountdown":"0",
             "alarms": "",
             "openChatManage": "0",
             "showLectuerOnlineNum":"0",
             "showAssistOnlineNum":"0",
             "hideExitButtonFlag": "0"
         },
         ...
     ]
  }

获取直播间信息

通过该接口可以获取直播间的信息,接口请求地址为:

http://api.csslcloud.net/api/room/search

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户id

返回数据包含如下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
room 直播间信息

room包含以下字段:

字段名 说明
id 直播间id
name 直播间名称
desc 直播间描述
status 直播间状态,10:正常; 20:关闭; 40:已封禁
publisherPass 推流端密码
playPass 播放端密码
assistantPass 助教密码
checkUrl 验证地址
templateType 模板类型
authType 验证类型
barrage 是否开启弹幕,0:不开启;1:开启
publishUrls 推流地址,第三方推流直播间可以获取到此参数
openLowDelayMode 开启低延时模式,"0"表示不开启;"1"表示开启
delayTime 延时时间,单位秒。低延时模式下该值为0.
showUserCount 在页面显示用户在线人数,"0"表示不显示;"1"表示显示
openHostMode 开启主持人模式,"0"表示不开启;"1"表示开启
hostLoginMode 主持人登录模式,"0"表示网页登录;"1"表示客户端登录
foreignPublish 是否开启第三方推流。0:不开启;1:开启
warmVideoId 插播暖场视频,为空,表示关闭
liveStartTime 直播开始时间
playerBackgroundHint 播放器提示语
manuallyRecordMode 手动录制模式。0:关闭:开启
clientDocPermissions 讲师文档权限。0:关闭;1:开启
repeatedLoginSetting 重复登录设置;0:允许后进入者登录;1:禁止后进入者登录,对讲师端和观看端生效
maxAudienceNum 直播间并发人数上限
documentDisplayMode 文档显示模式。1:适合窗口;2:适合宽度
openLiveCountdown 开启倒计时功能。0:不开启;1:开启
showLectuerOnlineNum 讲师端显示在线人数。0:不显示;1:显示
showAssistOnlineNum 助教主持人端显示在线人数。0:不显示;1:显示
openMarquee 跑马灯功能。0:关闭;1:开启
openChatManage 聊天审核是否开启。0:不开启;1:开启
hideExitButtonFlag 隐藏观看端退出按钮。0:不开启;1:开启
alarms 直播提醒设置,格式如下:[{"time":"","desc":""},{"time":"","desc":""},{"time":"","desc":""}] time为提醒时间点(单位:分钟),类型为字符串,取值范围1-1000的整数;desc为提醒内容,类型为字符串,最多20个字符
openTextPicLive 移动H5页面是否显示图文直播。0:隐藏;1:显示
inRemindFlag 进入直播是否提醒:1-是;0-否
inRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割
inBeContent 进入直播提醒内容前段
inAfContent 进入直播提醒内容后段
outRemindFlag 退出直播是否提醒:1-是;0-否
outRole 进入直播提醒角色:1-讲师;2-助教;3-主持人;4-观看端,以逗号, 分割
outBeContent 退出直播提醒内容前段
outAfContent 退出直播提醒内容后段
privateChat 私聊开关,1: 开启,0: 关闭

JSON格式的返回信息如下:

 {
     "result": "OK",
     "room": {
             "id": "76620AD36E2F23719C33DC5901307461",
             "name": "直播间名称",
             "desc": "直播间描述",
             "status": 10,
             "publisherPass": "PubToken",
             "playPass": "PlayToken",
             "assistantPass": "assToken",
             "checkUrl": "http://check.xxx.com/api/viewer/check",
             "templateType": 1,
             "authType": 1,
             "barrage": 1,
             "publishUrls": [
            "rtmp://xxxx.xxxx.net/live/EE98D675ABF4FEA99C33DC5901307461_0",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_1",
            "rtmp://xxxx.xxxx..net/live/EE98D675ABF4FEA99C33DC5901307461_2"
        ],
             "openLowDelayMode": "1",
             "delayTime": "0",
             "showUserCount": "1",
             "openHostMode": "0",
             "hostLoginMode": "0",
             "foreignPublish": 0,
             "warmVideoId": "",
             "liveStartTime":"2015-01-02 12:30:01",
             "playerBackgroundHint":"你好",
             "manuallyRecordMode":"0",
             "clientDocPermissions":"0",
             "openMarquee": "0",
             "repeatedLoginSetting":"0",
             "maxAudienceNum":"100",
             "openTextPicLive": "0",
             "documentDisplayMode":"1",
             "openLiveCountdown":"0",
             "alarms": "",
             "openChatManage": "0",
             "showLectuerOnlineNum":"0",
             "showAssistOnlineNum":"0",
             "hideExitButtonFlag": "0",
              "inRemindFlag": "1",
              "inBeContent": "欢迎",
              "inAfContent": "进入直播间",
              "inRole": [
                  1,
                  4,
                  2,
                  3
              ],
              "outRemindFlag": "1",
              "outBeContent": "",
              "outAfContent": "离开直播间",
              "outRole": [
                  1,
                  4,
                  2,
                  3
              ]
     }
  }

获取直播列表

通过该接口获取指定直播间下历史直播信息,接口请求地址为:

http://api.csslcloud.net/api/v2/live/info

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1
starttime 查询起始时间,如需按时间范围查询可添加该参数和下面的endtime参数,该查询是按直播的开始时间作为查询条件的。 可选,如果填写该参数则endtime参数必填;格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-01 12:30:00"
endtime 查询截止时间 可选 ,如果填写该参数则starttime必填;格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-02 12:30:00"

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 直播总数
pageIndex 页码
lives 直播列表信息

lives包含以下字段:

字段名 说明
id 直播id
startTime 开始直播时间
endTime 结束直播时间
templateType 模板类型
sourceType 直播来源类型,0:正常直播;1:合并回放生成; 2:迁移回放生成; 3:上传回放生成

JSON格式的返回信息如下:

{
      "result" : "OK",
         "count" : "100",
         "pageIndex" : "1",
         "lives" : [
             {
                 "id" : "753C612EB38A8D5A",
                 "startTime" : "2015-01-01 00:00:00",
                 "endTime" : "2015-01-01 23:00:00",
                 "recordVideoStatus" : 0,
                 "templateType": 5,
                 "sourceType": 0
             },
             ...
         ]
    }

删除直播

通过该接口可以删除直播,同时会删除该直播下的全部回放,删除后不可恢复,接口请求地址为:

http://api.csslcloud.net/api/live/delete

需要传递以下参数:

参数 说明
liveids 直播id,支持多个,id之间以英文逗号","分隔,批量删除数量不能超过100个
userid CC账户ID

JSON格式的返回信息如下:

{
      "result": "OK"
  }

查询回放列表

通过该接口可以分页获取回放列表的信息,接口请求地址为:

http://api.csslcloud.net/api/v2/record/info

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1
starttime 查询起始时间,如需按时间范围查询可添加该参数和下面的endtime参数,该查询是按直播的开始时间作为查询条件的。 可选,如果填写该参数则endtime参数必填;格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-01 12:30:00"
endtime 查询截止时间 可选 ,如果填写该参数则starttime必填;格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-02 12:30:00"
liveid 直播id 可选,将只查询该直播下的回放信息

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 回放总数
pageIndex 页码
records 回放列表信息

records包含以下字段:

字段名 说明
id 回放id
liveId 直播id
startTime 开始录制时间
stopTime 结束录制时间
recordStatus 录制状态,0表示录制未结束,1表示录制完成(回放生成,不包括离线CCR)
recordVideoId 录制视频id,如果recordStatus为0则返回-1
replayUrl 回放地址,当recordStatus为0时返回""
offlinePackageUrl 离线包下载地址,注:只有开通离线播放权限才会返回该参数
offlinePackageMd5 离线包md5,注:只有开通离线播放权限才会返回该参数
offlinePackageSize 离线包文件大小,单位Byte,注:只有开通离线播放权限才会返回该参数
templateType 模板类型
sourceType 回放来源,0:录制; 1:合并; 2:迁移; 3:上传
title 回放标题
desc 回放描述

JSON格式的返回信息如下:

{
       "result" : "OK",
       "count" : "100",
       "pageIndex" : "1",
       "records" : [
           {
               "id" : "753C612EB38A8D5A",
               "liveId" : "853C612EB38A8D5A",
               "startTime" : "2015-01-01 00:00:00",
               "stopTime" : "2015-01-01 23:00:00",
               "recordStatus": 1,
               "recordVideoId" : "953C612EB38A8D5A",
               "replayUrl" : "http://xxx",
               "offlinePackageUrl" : "http://yyy",
               "offlinePackageMd5" : "xxxxxdddddddddddddddddddddddddddd",
                "offlinePackageSize": 2350422,
               "templateType": 5,
               "sourceType": 1,
               "title": "回放标题",
               "desc": "回放描述"
           },
           ...
       ]
  }

查询回放信息

通过该接口获取单个回放信息,接口请求地址为:

http://api.csslcloud.net/api/v2/record/search

需要传递以下参数:

参数 说明 备注
userid CC账户ID
recordid 回放id

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
record 回放信息

record包含以下字段:

字段名 说明
id 回放Id
liveId 直播Id
startTime 开始录制时间, 格式为"yyyy-MM-dd HH:mm:ss"
stopTime 结束录制时间, 格式为"yyyy-MM-dd HH:mm:ss", 如果录制未结束,该值则为""
recordStatus 录制状态,0表示录制未结束,1表示录制完成
replayUrl 回放地址,当recordStatus为0时返回""
recordVideoId 录制视频id,如果recordStatus为0则返回-1
offlinePackageUrl 离线包下载地址,注:只有开通离线播放权限才会返回该参数
offlinePackageMd5 离线包md5,注:只有开通离线播放权限才会返回该参数
offlinePackageSize 离线包文件大小,单位Byte,注:只有开通离线播放权限才会返回该参数
downloadUrl 回放视频下载地址,该下载地址具有时效性,有效时间为2小时
templateType 模板类型
sourceType 回放来源,0:录制; 1:合并; 2:迁移; 3:上传
title 回放标题
desc 回放描述

JSON格式的返回信息如下:

 {
    "result" : "OK",
    "record" : {
            "id" : "753C612EB38A8D5A",
            "liveId" : "853C612EB38A8D5A",
            "startTime" : "2015-01-01 00:00:00",
            "stopTime" : "2015-01-01 23:00:00",
            "recordStatus": 1,
            "recordVideoId" : "953C612EB38A8D5A",
            "replayUrl" : "http://xxx",
            "offlinePackageUrl" : "http://yyy",
            "offlinePackageMd5" : "xxxxxdddddddddddddddddddddddddddd",
            "offlinePackageSize": 2350422,
            "downloadUrl" : "http://zzz",
            "templateType": 5,
            "sourceType": 1,
            "title": "回放标题",
            "desc": "回放描述"
        }
    }

合并回放

通过该接口可以对同一直播间下相同模板类型的回放进行合并,接口请求地址为:

http://api.csslcloud.net/api/live/merge

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
roomid 直播间id 必须
recordids 回放ID集合 必须,中间以英文逗号间隔,最多支持3个回放合并

返回数据:

{
    "result": "OK",
    "recordId": "1898E3CD7F97BEED" // 合并生成新的回放ID
}

编辑回放

通过该接口编辑回放信息,接口请求地址为:

http://api.csslcloud.net/api/record/edit

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必填
recordid 回放id 必填
title 回放标题,最大字符40/td> 必填,标题头尾的空格字符会自动删除
desc 回放描述,最大字符5000 可选

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败

JSON格式的返回信息如下:

 {
    "result" : "OK"
 }

删除回放

通过该接口删除一个或多个回放信息,删除后不可恢复,接口请求地址为:

http://api.csslcloud.net/api/record/delete

需要传递以下参数:

参数 说明 备注
userid CC账户ID
recordids 回放id 支持多个回放id,id之间以英文逗号","分隔,批量删除数量不能超过100个

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败

JSON格式的返回信息如下:

 {
    "result" : "OK"
 }

获取正在直播的直播间列表

该接口可获取用户账号下所有正在进行直播的直播间列表,接口请求地址为:

http://api.csslcloud.net/api/rooms/broadcasting

需要传递以下参数:

参数 说明
userid CC账户ID

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
rooms 房间列表

房间列表含有以下字段:

字段名 说明
roomId 房间ID
liveId 正在直播的直播ID
startTime 直播开始时间,格式为"yyyy-MM-dd HH:mm:ss"

JSON格式的返回信息如下:

{
       "result": "OK",
       "rooms": [
           {  
               "roomId": "76620AD36E2F23719C33DC5901307461",
               "liveId": "63835A29B2A11961",
               "startTime": "2016-11-28 20:00:00"
           },
           ...
       ]
  }

获取直播间直播状态

通过该接口获取直播间的直播状态,接口请求地址为:

http://api.csslcloud.net/api/rooms/publishing

需要传递以下参数:

参数 说明
roomids 直播间id(以英文逗号,区分),批量查询直播间数量不能超过100个
userid CC账户ID

JSON格式的返回信息如下:

{
      "result": "OK",
        "rooms": [{
            "liveStatus": 0,
            "roomId": "E568A3195950ED7C9C33DC5901307461"
        },
        ...
        {
            "startTime": "2016-11-28 20:00:00",
            "liveStatus": 1,
            "liveId": "3F35109F9F77F2A8",
            "roomId": "76620AD36E2F23719C33DC5901307461"
        }]
  }

返回信息:

参数 说明
result "OK":请求成功,否则请求失败
rooms 返回查询直播间信息
liveStatus 0:直播未开始,1:正在直播
startTime 直播开始时间,若直播未开始,不返回该参数
liveId 直播ID,若直播未开始,不返回该参数
roomId 直播间ID

获取直播间连接数

通过该接口可以获取直播间的连接数统计信息,请求次数上限为2次/分钟,接口请求地址为:

http://api.csslcloud.net/api/statis/connections

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户ID
starttime 开始时间,精确到秒,例:"2015-01-02 12:30:00"
endtime 结束时间,精确到秒,例:"2015-01-02 13:30:00",endtime和starttime相差不能超过7天

返回字段包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
roomId 直播间id
connections 连接统计信息

connections包含以下字段:

字段名 说明
time 统计时间点
count 连接总数
replayCount 回放连接总数

JSON格式的返回信息如下:

{
     "result": "OK",
     "roomId": "76620AD36E2F23719C33DC5901307461",
     "connections": [
         {
             "time": "2016-11-28 20:00:30",
             "count": 9527,
             "replayCount": 7259
         },
         ...
     ]
  }

获取直播间模板信息

通过该接口可以获取直播间各模板信息,接口请求地址为:

http://api.csslcloud.net/api/viewtemplate/info

需要传递以下参数:

参数 说明
userid CC账户ID

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
templates 模板信息

viewTemplates包含多个模板信息,模板信息包含一些字段:

字段名 说明
type 模板类型
name 模板名称
desc 模板描述
iconPath 模板图标路径
pdfView 是否开启pdf视图,0:不开启;1:开启
chatView 是否开启聊天视图,0:不开启;1:开启
qaView 是否开启问答视图,0:不开启;1:开启

JSON格式的返回信息如下:

 {
     "result": "OK",
     "templates": [
         {
          "type": 2,
          "name": "模板二",
          "desc": "视频,聊天,问答",
          "iconPath": "ltab4",
          "chatView": 1,
          "pdfView": 0,
          "qaView": 1
      },
         ...
     ]
  }

获取直播间代码

通过该接口可以获取直播间的代码信息,包括观看地址信息、客户端登陆地址、助教端登录地址、推流地址(只有第三方推流直播间才可以获取到)、图文直播发布页地址(只有开启图文直播权限才可以获取到)。接口请求地址为:

http://api.csslcloud.net/api/room/code

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户ID

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
roomId 直播间id
clientLoginUrl 客户端登录地址
assistantLoginUrl 助教端登录地址
viewUrl 观看地址
publishUrls 推流地址,第三方推流直播间可以获取到此参数
hostLoginUrl 如果直播间为主持人模式,则返回主持人登录地址
promulgatorUrl 如果账号开通了图文直播权限,则返回图文直播发布地址

JSON格式的返回信息如下:

{
     "result": "OK",
       "roomId": "76620AD36E2F23719C33DC5901307461",
       "clientLoginUrl": "https://view.csslcloud.net/api/view/lecturer?roomid=76620AD36E2F23719C33DC5901307461&userid=753C612EB38A8D5A",
       "assistantLoginUrl": "https://view.csslcloud.net/api/view/assistant?roomid=xxxx&userid=xxxx",
       "viewUrl": "https://view.csslcloud.net/api/view/index?roomid=xxxx&userid=xxxx"
     "publishUrls": [
            "rtmp://xxxx.xxxx.net/live/xxxx",
            "rtmp://xxxx.xxxx..net/live/xxxx",
            "rtmp://xxxx.xxxx..net/live/xxxx"
        ],
       "hostLoginUrl": "https://view.csslcloud.net/api/view/manage?roomid=xxxx&userid=xxxx",
       "promulgatorUrl": "https://xxx.xxx.net/api/view/promulgator?roomId=xxxx&accountId=xxxx"
  }

获取直播间内用户进出信息

通过该接口可以获取直播间内用户进入,离开行为的统计,接口请求地址为:

http://api.csslcloud.net/api/statis/room/useraction

需要传入以下参数:

参数 说明
roomid 直播间id
userid CC账户ID
starttime 查询起始时间,格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-01 12:30:00"
endtime 查询截止时间,格式:yyyy-MM-dd HH:mm:ss ,endtime和starttime相差不能超过1天
action 按进入或离开查询,0表示进入直播间,1表示离开直播间
pageindex 可选,查询页码,默认为1
pagenum 可选,单页所查询的数据条数,默认为50,最大阈值为1000

返回数据包括以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
action 0表示进入直播间,1表示离开直播间
userActions 用户进入、离开行为记录

userActions包括用户的行为信息,包括以下字段:

字段名 说明
userId 用户Id,此Id为进入、离开行为的用户Id
userName 用户登录名称
userIp 用户IP地址
time 用户进入或离开时间

JSON格式的返回信息如下:

 {
    "result": "OK",
    "userActions": [
        {
            "userId": "780",
            "userName": "张三",
            "userIp": "111.206.170.241",
            "time": "2019-01-17 17:18:21.0"
        },
        ...
    ],
    "action": 0,
    "pageIndex": 1,
    "count": 5
 }

获取观看直播的访问记录

通过该接口可以获取观看直播的访问记录,接口请求地址为:

http://api.csslcloud.net/api/statis/live/useraction

注意:该接口仅支持查询2018年12月1日以后的直播

参数 说明 备注
userid CC账户ID
liveid 直播id
pagenum 每页显示的个数 可选,默认值为50,最大阈值为1000
pageindex 页码 可选,默认值为1

返回值说明:

参数名称 参数类型 参数说明
result 字符串 请求是否成功。OK:成功;FAIL:失败
count 数字 总访问次数
pageIndex 数字 当前页码
viewerId 字符串 用户ID
viewerName 字符串 用户昵称
viewerIp 字符串 用户IP
city 字符串 用户地域
enterTime 字符串 进入时间
leaveTime 字符串 离开时间
watchTime 数字 直播观看时长,单位:秒
terminal 数字 终端类型,0表示PC端,1表示移动端
customInfo 字符串 json格式字符串,自定义用户信息
userRole 字符串 用户角色,1:主讲、推流端角色, 2:助教端角色,3:主持人角色,4:学生、观看端角色

JSON格式的返回信息如下:

{
    "result": "OK",
    "userEnterLeaveActions": [
        {
            "viewerId": "d7ba862174754b1cb88138b8c3d94018",
            "viewerName": "21",
            "viewerIp": "111.26.170.241",
            "city": "中国\t北京\t北京\t",
            "enterTime": "2019-02-12 14:01:07",
            "leaveTime": "2019-02-12 14:01:51",
            "watchTime": 26,
            "terminal": 0,
            "customInfo": "",
            "userRole": 1
        },
        {
            "viewerId": "a9a589134a2e4037938d85a63cfb28bb",
            "viewerName": "二叉",
            "viewerIp": "111.26.170.241",
            "city": "中国\t北京\t北京\t",
            "enterTime": "2019-02-12 14:01:15",
            "leaveTime": "2019-02-12 14:01:51",
            "watchTime": 26,
            "terminal": 0,
            "customInfo": "",
            "userRole": 4
        }
    ],
    "pageIndex": 1,
    "count": 2
}

获取直播互动的统计信息

通过该接口可以获取直播互动的统计信息,接口请求地址为:

http://api.csslcloud.net/api/statis/interactive
参数 说明 备注
userid CC账户ID
liveid 直播id
pagenum 每页显示的个数 可选,默认值为50,最大阈值为1000
pageindex 页码 可选,默认值为1

返回值说明:

参数名称 参数类型 参数说明
result 字符串 请求是否成功。OK:成功;FAIL:失败
count 数字 总人数
pageIndex 数字 当前页码
viewerId 字符串 用户ID
viewerName 字符串 用户昵称
watchTime 数字 直播观看时长(秒)
enterLeaveCount 数字 进出次数
chatCount 数字 聊天次数
questionCount 数字 提问次数
rollcallCount 数字 签到次数
questionnaireCount 数字 答卷次数
classroomExaminationCount 数字 随堂测次数,2020-09-23以后的直播可以获取此参数

JSON格式的返回信息如下:

{
    "result": "OK",
    "count": 2,
    "pageIndex": 1,
    "liveViewerStatisConclusions": [
        {
            "viewerId": "27e7ce350aed4011873b384bbc1296d3",
            "viewerName": "12",
            "watchTime": 223,
            "enterLeaveCount": 1,
            "chatCount": 0,
            "questionCount": 0,
            "rollcallCount": 0,
            "questionnaireCount": 0,
            "classroomExaminationCount": 0
        },
        {
            "viewerId": "300227588049",
            "viewerName": "web空 ",
            "watchTime": 223,
            "enterLeaveCount": 1,
            "chatCount": 0,
            "questionCount": 0,
            "rollcallCount": 0,
            "questionnaireCount": 0,
            "classroomExaminationCount": 0
        }
    ]
}

获取观看直播的统计信息

通过该接口可获取观看直播的统计信息,请求次数上限为20次/分钟,统计延迟30分钟,请在直播结束30分钟以后查询。 接口请求地址为:

http://api.csslcloud.net/api/statis/userview

需要传递以下参数:

参数 说明
liveid 直播id
userid CC账户ID

JSON格式的返回信息如下:

{
    "result": "OK",
    "status": 1,
    "liveId": "xxxxxxxx",
    "maxConcurrent": 100,
    "totalCount": 1000,
    "uaCount": {
        "pc": 100,
        "mobile": 900
    },
    "customUaCount": {
        "customua1": 100,
        "customua2": 200
        ...
    }
}

返回值说明:

参数名称 参数类型 参数说明
result 字符串 请求是否成功。OK:成功;FAIL:失败
liveId 字符串 查询直播ID
status 数字 0:统计未完成,1:统计完成
maxConcurrent 数字 直播最大并发人数
totalCount 数字 总观看数
uaCount 对象 默认ua统计信息
pc 数字 默认ua统计PC观看总数
mobile 数字 默认ua统计Mobile观看总数
customUaCount 对象 用户自定义uatype统计观看数

获取单个直播回放的观看统计信息

通过该接口可以获取单个回放观看用户登录,退出行为统计。接口请求地址为:

http://api.csslcloud.net/api/statis/record/useraction

需要传入以下参数:

参数 说明
recordid 录制id
userid CC账户ID
starttime 查询起始时间,格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-01 12:30:00"
endtime 查询截止时间,格式:yyyy-MM-dd HH:mm:ss ,endtime和starttime相差不能超过7天
action 按登录或退出行为类型查询,0表示登录,1表示退出
pageindex 可选,查询页码,默认为1
pagenum 可选,单页所查询的数据条数,默认为50,最大阈值为1000

返回数据包括以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 数据总条数
pageIndex 当前页码
action 0表示登录,1表示退出
userActions 用户登录、退出行为记录

userActions包括用户的行为信息,包括以下字段:

字段名 说明
userId 用户Id,此Id为登录、退出行为的用户Id
userName 用户登录名称
userIp 用户IP地址
time 用户进入或离开时间

JSON格式的返回信息如下:

 {
    "result": "OK",
    "userActions": [
        {
            "userId": "8662c8b4de7c4d758146186402e9b00b",
            "userName": "cccc",
            "userIp": "111.206.170.241",
            "time": "2019-01-03 14:11:23.0"
        },
        {
            "userId": "8662c8b4de7c4d758146186402e9b00b",
            "userName": "aaaa",
            "userIp": "111.206.170.241",
            "time": "2019-01-03 14:12:42.0"
        },
        {
            "userId": "2ab26606d60241afb1d0c09652840686",
            "userName": "abc",
            "userIp": "111.206.170.241",
            "time": "2019-01-04 09:36:13.0"
        }
    ],
    "action": 0,
    "pageIndex": 1,
    "count": 3
 }

获取所有直播回放的观看统计信息

通过该接口可以获取观看直播回放的用户登录,退出行为统计。接口请求地址为:

http://api.csslcloud.net/api/statis/user/record/useraction

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
starttime 查询起始时间 必须,格式:yyyy-MM-dd HH:mm:ss ,例:"2015-01-01 12:30:00"
endtime 查询截止时间 必须,格式:yyyy-MM-dd HH:mm:ss ,endtime和starttime相差不能超过1天
action 按登录或退出行为类型查询,0表示登录,1表示退出
pageindex 查询页码 可选,默认为1
pagenum 单页所查询的数据条数 可选,默认为50,最大阈值为1000

返回数据包括以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 数据总条数
pageIndex 当前页码
action 0表示登录,1表示退出
userActions 用户登录、退出行为记录

userActions包括用户的行为信息,包括以下字段:

字段名 说明
recordId 回放Id
roomId 直播间Id
userId 用户Id,此Id为登录、退出行为的用户Id
userName 用户登录名称
userIp 用户IP地址
time 用户进入或离开的时间

JSON格式的返回信息如下:

 {
    "result": "OK",
    "userActions": [
        {
            "userId": "c0f67aec0dcd4b47a6e646653bbd7a35",
            "userName": "ccc",
            "userIp": "111.206.10.21",
            "time": "2019-01-02 14:27:46.0",
            "recordId": "D66B63F89917A1CB",
            "roomId": "82C9DDA7A237303A9C33DC5901307461"
        },
        {
            "userId": "c0f67aec0dcd4b47a6e646653bbd7a35",
            "userName": "bbb",
            "userIp": "111.206.10.21",
            "time": "2019-01-02 14:28:17.0",
            "recordId": "D66B63F89917A1CB",
            "roomId": "82C9DDA7A237303A9C33DC5901307461"
        },
        {
            "userId": "e194b87b469e441ab896ea87f2937cbf",
            "userName": "aaa",
            "userIp": "111.206.10.41",
            "time": "2019-01-02 17:19:47.0",
            "recordId": "B9344394BF816F90",
            "roomId": "086C4E55A8B5FEC19C33DC5901307461"
        }
    ],
    "action": 0,
    "pageIndex": 1,
    "count": 3
 }

获取聊天信息

通过该接口可以分页获取直播的聊天信息,接口请求地址为:

http://api.csslcloud.net/api/live/chatmsg

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
liveid 直播id
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 聊天总数
chatMsgs 聊天列表信息

chatMsgs包含以下字段:

字段名 说明
viewerId 观众id
viewerName 观众名称
viewerRole 观众角色(0:未统计,1:主讲,2:助教,3:主持人,4:学员)
time 聊天时间
content 聊天内容

JSON格式的返回信息如下:

{
      "result": "OK",
      "count": 100,
      "chatMsgs": [
          {
              "content": "粮仓到底还是满了",
              "time": "2016-11-28 20:30:33",
              "viewerName": "苍井满",
              "viewerId": "0cda7ng03j9502ian",
                "viewerRole": 0
          }
    ...
      ]
  }

获取抽奖信息

通过该接口可以分页获取直播的抽奖信息,接口请求地址为:

http://api.csslcloud.net/api/live/lotterys

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
liveid 直播id
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
lotteryRoundCount 抽奖轮数
lotteryRounds 抽奖轮数信息

lotteryRounds包含以下字段:

字段名 说明
lotteryId 抽奖ID
lotteryCount 中奖人数
lotteries 中奖用户信息
time 中奖时间
lotteryIndex 中奖顺序
viewerName 中奖人名称
viewerId 中奖人Id
lotteryCode 中奖码

JSON格式的返回信息如下:

 {
      "result": "OK",
      "lotteryRounds": [
          {
              "lotteries": [
                  {
                      "time": "2016-11-28 20:30:33",
                      "lotteryIndex": 1,
                      "viewerName": "苍井满",
                      "lotteryCode": 9876,
                      "viewerId": "0cda7ng03j9502ian"
                  }
      ...
              ],
              "lotteryCount": 10,
                "lotteryId": "20160928020202222"
          }
      ],
      "lotteryRoundCount": 8
  }

获取问答信息

通过该接口可以分页获取直播的问答信息,接口请求地址为:

http://api.csslcloud.net/api/live/qas

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
liveid 直播id
pagenum 每页显示的个数 可选,系统默认值为50,最大值为100
pageindex 页码 可选,系统默认值为1

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
questionCount 提问总数
questions 提问列表信息

questions包含以下字段:

字段名 说明
viewerId 学员id
viewerName 学员名称
viewerRole 回答者角色(0:未统计,1:主讲,2:助教,3:主持人,4:学员)
time 操作时间
content 内容
answers 回答列表
isPrivate 是否私密回答(0:公开回答 1:私密回答)

JSON格式的返回信息如下:

{
      "result": "OK",
      "questionCount": 1,
      "questions": [
          {
        "viewerName": "铁柱",
              "viewerId": "w1c0a9n87lxcm77234mn",
              "content": "怎么质检3xing手机?",
              "time": "2016-11-28 20:30:50",
              "answers": [
                  {
                      "content": "手机充上电,OK,换下一个手机,Not OK,换下一个质检员",
                      "time": "2016-10-10 17:00:50",
                      "isPrivate": 1,
                      "viewerName": "全蛋",
                      "viewerId": "7a9n4m8w1c07lx2cm73n",
                        "viewerRole": 0
                  }
          ...
              ]
          }
    ...
      ]
  }

获取签到信息

通过该接口可以获取直播的签到信息,接口请求地址为:

http://api.csslcloud.net/api/live/rollcall

需要传递以下参数:

参数 说明 备注
roomid 直播间id
userid CC账户ID
liveid 直播id

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
count 签到次数
rollcalls 签到列表信息

rollcalls包含以下字段:

字段名 说明
totalNum 总人数
duration 签到时长
time 操作时间
rollcallId 签到ID
checkedNum 签到人数

JSON格式的返回信息如下:

{
      "result": "OK",
      "count": 4,
      "rollcalls": [
          {
              "totalNum": 3,
              "duration": 10,
              "time": "2016-11-28 20:20:20",
              "rollcallId": "13358DE27D943A99",
              "checkedNum": 0
          }
    ...
      ]
  }

获取签到用户信息

通过该接口获取签到用户信息,接口请求地址为:

http://api.csslcloud.net/api/v2/live/rollcall/viewers

需要传递以下参数:

参数 说明
roomid 直播间id
userid CC账户ID
liveid 直播id
rollcallid 签到ID
pageindex 可选,查询页码,默认为1
pagenum 可选,单页所查询的数据条数,默认为50,最大阈值为100

返回数据包含以下字段:

字段名 说明
result 请求是否成功。OK:成功;FAIL:失败
viewers 签到用户列表信息

viewers包含以下字段:

字段名 说明
viewerId 观看者ID
viewerName 观看者名称
checked 是否签到,1:签到,0:未签到

JSON格式的返回信息如下:

  {
    "result": "OK",
    "viewers": [
        {
            "viewerName": "铁柱",
            "viewerId": "a9a589134a2e4037938d85a63cfb28bb",
            "checked": 0
        },
        ...
    ],
    "pageIndex": 1,
    "count": 10
  }

获取问卷信息

通过该接口获取问卷信息,接口请求地址为:

http://api.csslcloud.net/api/live/questionnaires

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
liveid 直播id 必须

返回数据:

{
    "result": "OK",
    "questionnaires": [{ // 问卷信息
        "id": "8CF77A91E659162F", // 问卷ID
        "title": "用户问卷调查", // 问卷题目
        "submitAnswerViewerCount": 100, // 交卷总人数
        "subjects": [{ // 问卷题目信息
            "id": "C91F302B7655688E", // 题目ID
            "index": 0, // 题目索引
            "content": "性别?", // 题目内容
            "type": 0, // 题目类型:0单选,1多选,2问答
            "options": [{ // 选项
                "id": "64367D8CDD368AE3", // 选项ID
                "index": 0, // 选项索引
                "content": "男", // 选项内容
                "correct": 0, // 是否正确
                "selectedCount": 100 // 选择该项的人数
            },{
                "id": "906B22CC9DEA925D",
                "index": 1,
                "content": "女",
                "correct": 0,
                "selectedCount": 200
            },{
                "id": "C1CC3275BBCE7F35",
                "index": 2,
                "content": "保密",
                "correct": 1,
                "selectedCount": 300
            }]
        },{
            "id": "C91F302B7655688E",
            "index": 1,
            "content": "掌握的编程语言?",
            "type": 1,
            "options": [{
                "id": "0BB798B9190A7C25",
                "index": 0,
                "content": "Java",
                "correct": 0,
                "selectedCount": 1000
            },{
                "id": "7EFD4A88DEF569AC",
                "index": 1,
                "content": "Python",
                "correct": 0,
                "selectedCount": 2000
            },{
                "id": "CB5F16DD59540FBC",
                "index": 2,
                "content": "Go",
                "correct": 1,
                "selectedCount": 2000
            },{
                "id": "0AC802A9B58C5E83",
                "index": 3,
                "content": "JavaScript",
                "correct": 1,
                "selectedCount": 2020
            }]
        },{
            "id": "10EB3D79A0CAD63E",
            "index": 2,
            "content": "其他技能?",
            "type": 1
        }]
    }

获取用户答卷信息

通过该接口获取用户答卷信息,接口请求地址为:

http://api.csslcloud.net/api/live/questionnaire/viewers

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
liveid 直播id 必须
questionnaireid 问卷ID 必须
pageindex 页码 可选,默认1
pagenum 每页显示的个数 可选,单页所查询的数据条数,默认为50,最大阈值为500

返回数据:

{
    "result": "OK",
    "submitAnswerViewerCount": 1, // 提交的总人数
    "pageNum": 100,
    "pageIndex": 1,
    "viewers": [{ // 学员提交问卷的详细信息
        "id": "9c2ea7b260824f1d8e", // 学员ID
        "name": "小明", // 学员名称
        "submitTime": "2017-03-31 10:57:31", // 学员提交时间
        "answers": [{ // 学员提交答案信息
            "subjectId": "C91F302B7655688E", // 题目ID
            "selectedOptionId": "64367D8CDD368AE3" // 选择选项ID
        },{
            "subjectId": "C91F302B7655688E",
            "selectedOptionIds": "0BB798B9190A7C25,7EFD4A88DEF569AC,CB5F16DD59540FBC,0AC802A9B58C5E83"
        },{
            "subjectId": "10EB3D79A0CAD63E",
            "answerContent": "云和分布式计算, 统计分析和数据挖掘, Web架构和开发框架, 中间件和集成软, 用户界面设计, 网络和信息安全, 移动开发, SEO/SEM营销, 存储系统和管理"
        }]
        }
    ]
}

获取随堂测信息

通过该接口获取随堂测信息,请求接口地址:

http(s)://api.csslcloud.net/api/practice/info

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
liveid 直播id 必须
pageindex 页码 可选,默认1
pagenum 每页显示的个数 可选,单页所查询的数据条数,默认100 区间[1~1000]

返回参数示例及说明: 成功:

{
    "result": "OK",
    "count": 1231, // 总共发布了多少次随堂测
    "pageIndex": 1, // 第几页
    "practices": [ // 随堂测信息
      {
          "id": "2482038403", // 随堂测ID
          "publishTime": "2019-01-12 14:35:12", // 发布时间
          "type": 2, // 随堂测类型 判断:0,单选:1,多选:2  
          "options": [ // 随堂测选项信息
              {
                  "index": 0, // 选项索引
                  "isCorrect": 1 // 选项是否为正确答案 0 错误 1 正确
              },
              {
                  "index": 1, // 选项索引
                  "isCorrect": 1 // 选项是否为正确答案 0 错误 1 正确
              },
              {
                  "index": 2, // 选项索引
                  "isCorrect": 0 // 选项是否为正确答案 0 错误 1 正确
              }
          ]
      }
    ]
}

失败:

{
    "result": "FAIL",
    "reason": "错误原因"
}

获取用户提交随堂测信息

通过该接口可以获取用户提交随堂测信息,接口请求地址:

http(s)://api.csslcloud.net/api/practice/submit/info

需要传递以下参数:

参数 说明 备注
userid CC账户ID 必须
liveid 直播id 必须
practiceid 随堂测ID 必须
pageindex 页码 可选,默认1
pagenum 每页显示的个数 可选,单页所查询的数据条数,默认100 区间[1~1000]

返回参数示例及说明: 成功:

{
    "result": "OK",
    "count": 1231, // 总共有多少个用户提交答案
    "pageIndex": 1, // 第几页
    "submitDatas": [
         {
             "viewerId": "432842804", // 观看者ID
             "viewerName": "zhangfei", // 观看者昵称
             "submitTime": "2019-01-12 15:12:34", // 提交时间
             "submitOptions": [0,1,2,3] // 提交的选项索引
         }
    ]
}

失败:

{
    "result": "FAIL",
    "reason": "具体错误原因" 
}

获取直播打卡信息

通过该接口获取直播打卡信息,请求接口地址:

http(s)://api.csslcloud.net/api/punch/list

需要传递以下参数:

参数名称 是否必须 备注
accountId 账户id
liveId 加密直播ID
pageIndex 分页页码,最小值为1,默认值为1。
pageSize 分页大小,最小值为1,最大值为100,默认值为100。

返回数据说明:

名称类型是否必须默认值备注其他信息
successboolean必须
errorobject非必须
├─ codestring必须错误代码。
├─ messagestring必须错误描述。
dataobject非必须
├─ countnumber必须
├─ punchesobject []必须

item 类型: object

├─ idstring必须打卡ID。
├─ publisherIdstring必须发起者 ID。
├─ publisherNamestring必须发起者名称。
├─ createTimestring必须打卡开始时间,格式yyyy-MM-dd HH:mm:ss。
├─ expireTimestring非必须打卡到期时间,格式 yyyy-MM-dd HH:mm:ss。打卡无到期时间时,此项不存在。
├─ allowLaterboolean必须是否允许后进入者参与打卡。
├─ isFinishboolean必须打卡互动是否结束。
├─ finishTimestring非必须打卡结束时间,格式yyyy-MM-dd HH:mm:ss。isFinish=true 时必须。
├─ totalnumber必须应打卡人数。
├─ punchednumber必须实际打卡人数。isFinish=false 时,此值为0,无意义。

获取用户打卡记录

通过该接口可以获取用户打卡记录信息,接口请求地址:

http(s)://api.csslcloud.net/api/punch/detail

需要传递以下参数:

参数名称 是否必须 备注
accountId 账户id
punchId 打卡 ID。
pageIndex 分页页码,最小值为1,默认值为1。
pageSize 分页大小,最小值为1,最大值为100,默认值为100。

返回数据说明:

名称类型是否必须默认值备注其他信息
successboolean必须接口处理结果。
errorobject非必须失败时的错误信息,success=false时必须。
├─ codenumber必须错误代码。
├─ messagestring必须错误描述。
dataobject非必须成功时返回的数据,success=true时必须。
├─ punchobject必须打卡信息。
├─ idstring必须打卡ID。
├─ publisherIdstring必须发起者 ID。
├─ publisherNamestring必须发起者名称。
├─ createTimestring必须打卡开始时间,格式yyyy-MM-dd HH:mm:ss。
├─ totalnumber必须应打卡人数。
├─ punchednumber必须实际打卡人数。
├─ durationnumber必须打卡持续时间,单位:秒。 无过期时间时,返回完成时间和开始时间的差。 若有过期时间,返回完成时间和开始时间的差和过期时间和开始时间的差之间较小的值
├─ punchViewersobject []必须参与打卡学员列表,按分页返回。

item 类型: object

├─ idstring必须学员 ID。
├─ namestring必须 学员名称。
├─ createTimestring必须参与打卡时间,格式yyyy-MM-dd HH:mm:ss。
├─ isPunchedboolean必须是否打卡。
├─ punchTimestring非必须打卡时间,格式yyyy-MM-dd HH:mm:ss。isPunched=true 时必须。

results matching ""

    No results matching ""