文档首页/实时音视频 SparkRTC/API参考/数据统计分析/查询用户列表 - ListRtcUserList
更新时间：2025-11-04 GMT+08:00
查看PDF
分享

查询用户列表 - ListRtcUserList

功能介绍

指定时间范围查询这段期间加入房间的用户列表。

最大查询跨度90天。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/{project_id}/rtc/users

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

app

是

String

应用id

room_id

否

String

房间id

uid

否

String

用户id

nickname

否

String

用户昵称

region

否

Array of strings

用户省份，支持省份名或缩写，如广东或者GD

isp

否

Array of strings

用户接入运营商

state

否

Array of strings

用户状态，取值如下：

  • FAIL：加入失败

  • ONLINE：在线

  • OFFLINE：离开

start_time

否

String

查询起始时间。UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T06:00:00Z，不写默认读取过去1小时数据数据。

end_time

否

String

查询结束时间。UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T06:00:00Z，不写默认为当前时间。

limit

否

Integer

查询结果限制

offset

否

Integer

查询偏移量

type

否

String

查询模式，取值如下：

  • detail：会话级

  • summary：用户级（默认）

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

X-Project-Id

否

String

使用AK/SK方式认证时必选，携带项目ID信息，与路径参数中的项目ID相同。

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求的唯一标识

表5 响应Body参数

参数

参数类型

描述

total

Integer

总数

limit

Integer

查询结果限制

offset

Integer

查询偏移量

users

Array of RtcUser objects

用户列表

表6 RtcUser

参数

参数类型

描述

domain

String

域名

app

String

应用标识

room_id

String

房间ID

uid

String

用户id

session

String

会话id

state

String

用户状态

  • FAIL： 加入失败

  • ONLINE：在线

  • OFFLINE：离开

nick_name

String

用户昵称

ip

String

用户接入IP

region

String

用户接入IP所在省份

isp

String

用户接入IP所在运营商

device_model

String

用户设备型号

platform

String

用户设备平台

sdk

String

用户sdk版本

join_time

String

用户加入房间时间。格式为：YYYY-MM-DDThh:mm:ssZ

leave_time

String

用户离开房间时间。格式为：YYYY-MM-DDThh:mm:ssZ，若用户未离开，则返回 “-”

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET /v1/{project_id}/rtc/users?app=5fa682b34a974f7ad24d223b

响应示例

状态码：200

查询成功返回。

{
  "total" : 1000,
  "limit" : 10,
  "offset" : 0,
  "users" : [ {
    "domain" : "603f71bdfa163e500aff1106c8bxxxxx.sparkrtc.myhuaweicloud.com",
    "app" : "603f71bdfa163e500aff1106c8xxxxx",
    "room_id" : "ac146d0f27799161917160702xxxxx",
    "uid" : "xxxxx",
    "session" : "0afa1af5a41a11eb802b7d4bc77xxxxx",
    "state" : "ONLINE",
    "nick_name" : "xxxxx",
    "ip" : "113.140.81.xx",
    "region" : "陕西",
    "isp" : "CTCC",
    "device_model" : "iphone",
    "platform" : "web-Mac10_15_4",
    "sdk" : "1.4.0",
    "join_time" : "2021-04-23T09:55:32Z",
    "leave_time" : "-"
  } ]
}

状态码：400

查询失败返回

{
  "error_code" : "DATA.100011001",
  "error_msg" : "Required String parameter 'app' is not present"
}

状态码

状态码

描述

200

查询成功返回。

400

查询失败返回

错误码

请参见错误码。

父主题：数据统计分析

相关文档