400-881-9892

文档中心

官方文档,可查阅产品介绍、快速入门、用户指南、开发指南、API参考、SDK参考、帮助等信息。

文档中心 互动课堂

获取用户在线时长和上课时长(小班课)

Example

请求方式 POST

https://global.talk-cloud.net/api/room/v1/getRoomUserDuration

参数名 必选 类型 说明
Content-Type string application/json;
Tk-authkey string 企业Key
参数名 是否必选 类型 说明
serial string 房间编号:(该字段和thirdroomid必须至少填写一个)
thirdroomid string 用户自定义房间号:选填(该字段和serial必须至少填写一个)如果用户创建房间时自定义了房间号,可使用此字段
userId string 用户ID
startTime int 开始时间(时间截示例:1597852800。开始时间和结束时间均不传则默认查询24小时内的数据,如果填写开始时间但不填写结束时间则默认区间为开始时间至1个月后的时间,时间区间最大限制1个月且只支持查询1年内的数据)
endTime int 结束时间(时间截示例:1597852800。结束时间和开始时间均不传则默认查询24小时内的数据,如果填写结束时间但不填写开始时间则默认区间为1个月前的时间至结束时间,时间区间最大限制1个月且只支持查询1年内的数据)
userRoleId int 用户角色
page int 页码 (默认每页返回100条)
参数名称 类型 描述
result int 0成功,其他失败
total int 总条数
data object 返回数据
userid.userName string 用户名
userid.userRoleId string 用户角色
userid.onlineDuration int 多次在线总时长(秒)
userid.classDuration int 多次上课总时长(秒)

返回示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "result": 0,
  "total": 3,
  "data": {
        "ae111c29-4332-9bd3-3cbb-e764035cb676": {
            "userName": "admin",
            "userRoleId": "0",
            "onlineDuration": 1509,
            "classDuration": 1456
        },
        "7f0cce28-0b0a-1a68-d0e0-f04650039827": {
            "userName": "22",
            "userRoleId": "2",
            "onlineDuration": 1504,
            "classDuration": 1456
        },
        "e3501fbf-7be4-c6f5-8c7f-c3efc0ed68f8": {
            "userName": "33",
            "userRoleId": "2",
            "onlineDuration": 1498,
            "classDuration": 1456
        }
    },
  "msg": ""
}