16API

Example

POST getLiveLogininfo（注：此接口只支持查一年内的数据）

https://global.talk-cloud.net/WebAPI/getLiveLogininfo

Request

参数

参数名	是否必填	类型	说明
key	是	String	企业Key
serial	否	String	房间编号：选填(该字段和thirdroomid必须至少填写一个)
thirdroomid	否	String	用户自定义房间号：选填(该字段和serial必须至少填写一个)如果用户创建房间时自定义了房间号,可使用此字段
starttime	否	Int	开始时间（时间截示例：1597852800。开始时间和结束时间均不传则默认查询24小时内的数据，如果填写开始时间但不填写结束时间则默认区间为开始时间至1个月后的时间，时间区间最大限制1个月且只支持查询1年内的数据。优先级高于startdate）
endtime	否	Int	结束时间（时间截示例：1597852800。结束时间和开始时间均不传则默认查询24小时内的数据，如果填写结束时间但不填写开始时间则默认区间为1个月前的时间至结束时间，时间区间最大限制1个月且只支持查询1年内的数据。优先级高于enddate）
startdate	否	String	开始日期（格式示例：2020-01-01 10:00:00，开始日期和结束日期均不传则默认查询24小时内的数据，如果填写开始日期但不填写结束日期则默认区间为开始日期至1个月后的时间，时间区间最大限制1个月且只支持查询1年内的数据）
enddate	否	String	结束日期（格式示例：2020-01-01 10:00:00，结束日期和开始日期均不传则默认查询24小时内的数据，如果填写结束日期但不填写开始日期则默认区间为1个月前的时间至结束日期，时间区间最大限制1个月且只支持查询1年内的数据）
page	否	Int	页数（默认第一页，每页200条，第二页不返回uptablelist数据）

Response

参数名称	类型	描述
result	Int	code码.可根据result是否是0来判断是否成功 0：表示成功若调用失败,会返回错误码,具体看公共错误码信息。
uptablelist	Array	上台用户列表（返回所有）
count	Int	返回直播用户数据量
logininfo	Array	直播用户列表
seria	String	房间号
userid	String	用户id
username	String	用户名
entertime	String	进入时间
outtime	String	退出时间
duration	String	时长
terminal	String	终端 0windows端、1MAC、2ios、3android、4.linux 5.未知
terminal_details	String	观看终端：1客户端、2微信浏览器、3Safari浏览器、4Chrome浏览器、5其他
starttime	String	开始时间
endtime	String	结束时间
paytime	String	计费时长
videotype	String	分辨率
userroleid	String	课堂中的角色 0：主讲 1：助教 2: 学员 3：直播用户 4: 巡检员
entertimestamp	Int	进入时间戳
outtimestamp	Int	退出时间戳
starttimestamp	Int	开始时间戳
endtimestamp	Int	结束时间戳

ReturnJson

返回示例

{
    "result":0,
    "count":1,
    "uptablelist": [
        {
            "serial": "111111",
            "userid": "123123123123",
            "username": "李思淼",
            "entertime": "2020-08-29 09:48:47",
            "outtime": "2020-08-29 09:49:07",
            "duration": "20",
            "terminal":"0",
            "terminal_details":"1",
            "userroleid": "2",
            "starttime": "2020-08-29 09:48:47",
            "endtime": "2020-08-29 09:49:07",
            "paytime": "20",
            "videotype": "320*240",
            "entertimestamp":1598665727,
            "outtimestamp":1598665747,
            "startimestamp":1598665727,
            "endtimestamp":1598665747,
        }
    ]
    "logininfo":[
        {
            "serial":"111111",
            "userid":"123123123123",
            "username":"IWantSeeYouAgain",
            "entertime":"2020-06-17 17:05:04",
            "outtime":"2020-06-17 17:05:18",
            "duration":"14",
            "terminal":"0",
            "terminal_details":"1",
            "starttime":"2020-06-17 17:05:18",
            "endtime":"2020-06-17 17:05:18",
            "paytime":"0",
            "videotype":"320*240"
            "userroleid": "2",
            "entertimestamp":1592384704,
            "outtimestamp":1592384718,
            "startimestamp":1592384718,
            "endtimestamp":1592384718,
        }
    ]
}

错误码说明