查询实时质量 TOP 20 分组
更新时间不可用
获取指定维度下实时质量指标排名前 20 的分组数据。
GET
https://api.sd-rtn.com/beta/realtime/quality/dimension/top20该接口可为查询实时质量接口的 dimensionValues 参数提供内容输入。
鉴权
tsnumber必填
查询的时间范围起点，Unix 时间戳（秒）。实际查询范围为 [ts, ts + 20s ]。
appidstring必填
你的项目使用的 App ID。
productTypestring必填
要查询的产品类型，支持设为以下值：
Native：指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。WebRTC：指 Web 平台的声网 RTC SDK。
metricstring必填
要查询的指标，支持设为以下值：
joinSuccessRate：加入频道成功率。joinSuccessIn5sRate：5s 内加入频道成功率。audioFreezeRate：音频卡顿率。videoFreezeRate：视频卡顿率。networkDelay：网络延迟率。
dimensionstring必填
统计维度，仅支持单维度指定。支持设为以下值：
country：国家。region：地区。net：网络类型。sdk：SDK 版本。os：操作系统。device：设备型号。将默认返回维度对应 TOP 20 的值（仅当dimension为device时，将默认返回 TOP 50 的值）。
extraMetricsstring额外指标，用于辅助判断数据的有效性。仅支持设为 userCount，即当前维度下的用户数。
响应
OK
响应 Body
codenumber响应状态码。200 表示请求成功，详见响应状态码。
messagestring错误消息。
dataarray<object>由维度、指标数据和时间窗口的起止 Unix 时间戳（秒）组成的数组。
请求示例
curl --request GET \
--url "https://api.sd-rtn.com/beta/realtime/quality/dimension/top20?ts=1631837410&appid=string&productType=string&metric=string&dimension=string" \
--header 'Authorization: Basic <credentials>'响应示例
{
"code": 200,
"message": null,
"data": {
"list": [
{
"audioFreezeRate": 0.050833333333333335,
"windowStartTs": 1671624000,
"userCount": 2,
"device": "ldn-al00",
"windowEndTs": 1671624020
},
{
"audioFreezeRate": 0,
"windowStartTs": 1671624000,
"userCount": 2,
"device": "80HH",
"windowEndTs": 1671624020
},
{
"audioFreezeRate": 0,
"windowStartTs": 1671624000,
"userCount": 1,
"device": "20KNA004CD",
"windowEndTs": 1671624020
}
]
}
}