查询实时规模 TOP 20 分组
更新时间不可用
获取指定维度下实时通话人数排名前 20 的分组数据。
GET
https://api.sd-rtn.com/beta/realtime/usage/dimension/top20该接口可为查询实时规模接口的 dimensionValues 参数提供内容输入。
鉴权
tsnumber必填
查询的时间范围起点，Unix 时间戳（秒）。实际查询范围为 [ts, ts + 20s ]。
appidstring必填
你的项目使用的 App ID。
productTypestring必填
要查询的产品类型，支持设为以下值：
Native：指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。WebRTC：指 Web 平台的声网 RTC SDK。
metricunknown必填
要查询的指标，仅支持设为 userCount，即通话人数，一个用户 ID 在一个频道中计为一人，在多个频道中计为多人。
dimensionstring必填
统计维度，仅支持单维度指定。支持设为以下值：
country：国家。region：地区。net：网络类型。sdk：SDK 版本。os：操作系统。device：设备型号。将默认返回维度对应 TOP 20 的值（仅当dimension为device时，将默认返回 TOP 50 的值）。
响应
OK
响应 Body
codenumber响应状态码。200 表示请求成功，详见响应状态码。
messagestring错误消息。
dataarray<object>由维度、指标数据和时间窗口的起止 Unix 时间戳（秒）组成的数组。
请求示例
curl --request GET \
--url "https://api.sd-rtn.com/beta/realtime/usage/dimension/top20?ts=1631837410&appid=string&productType=string&dimension=string" \
--header 'Authorization: Basic <credentials>'响应示例
{
"code": 200,
"message": null,
"data": {
"list": [
{
"sdk": "3.6.1.1",
"userCount": 236,
"windowStartTs": 1631837410,
"windowEndTs": 1631837430
},
{
"sdk": "4.1.1",
"userCount": 82,
"windowStartTs": 1631837410,
"windowEndTs": 1631837430
},
{
"sdk": "2.9.1",
"userCount": 68,
"windowStartTs": 1631837410,
"windowEndTs": 1631837430
}
]
}
}