# 查询实时质量 (/zh-CN/api-reference/api-ref/agora-analytics/realtime-quality) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 获取实时的加入频道成功率、5s 加入频道成功率、音频卡顿率、视频卡顿率、网络延迟率。 - OpenAPI: /openapi/agora-analytics/analytics-rest-api.zh-CN.yaml - Operation ID: get-beta-realtime-quality-by_time_20sec - Method: GET - Path: /beta/realtime/quality/by_time_20sec - Endpoint: https://api.sd-rtn.com/beta/realtime/quality/by_time_20sec ## Servers - https://api.sd-rtn.com ## Authorization This endpoint requires authentication. - `Authorization` ## Parameters - `startTs` (query, required, number) - 查询的时间范围起点,Unix 时间戳(秒)。响应中会包含起点所在的时间窗口。 - `endTs` (query, required, number) - 查询的时间范围终点,Unix 时间戳(秒)。响应中不会包含终点所在的时间窗口。 - `appid` (query, required, string) - 你的项目使用的 [App ID](/zh-CN/introduction/glossary#appid)。 - `productType` (query, required, string) - 要查询的产品类型,支持设为以下值: - `Native`:指 Android、iOS、macOS、Windows 平台的声网 RTC SDK。 - `WebRTC`:指 Web 平台的声网 RTC SDK。 - `metric` (query, required, string) - 要查询的指标,支持设为以下值: - `joinSuccessRate`:加入频道成功率。 - `joinSuccessIn5sRate`:5s 内加入频道成功率。 - `audioFreezeRate`:音频卡顿率。 - `videoFreezeRate`:视频卡顿率。 - `networkDelay` :网络延迟率。 - `dimension` (query, optional, string) - 统计维度,仅支持单维度指定。支持设为以下值: - `country`:国家。 - `region`:地区。 - `net`:网络类型。 - `sdk`:SDK 版本。 - `os`:操作系统。 - `device`:设备型号。 你可以通过[获取实时质量 TOP 20 分组](realtime-quality-top20)获取当前 `dimension` 下的 TOP 值,再根据业务需要从中选取几个值,来作为下次请求时传入 `dimensionValues` 的值。 - `dimensionValues` (query, optional) - 统计维度的值 ,即对 `dimension` 中设定的维度指定取值,仅在传入 `dimension` 时有效。所有值必须用双引号包括,并以逗号分隔。 - `cname` (query, optional, string) - 频道名称。如果不填,代表查询该项目的整体指标。 - `uids` (query, optional, string) - 请求的用户 uid 列表,多个 uid 用逗号隔开(如 `uids=10001,10002,10003`),最多可以指定 10 个 uid。 如果填写了 `uids` 字段,请确保 `cname` 字段不为空,否则 `uids` 字段不生效。 ## Request body No request body. ## Responses ### 200 OK - `code` (number) - 响应状态码。200 表示请求成功,详见[响应状态码](/zh-CN/realtime-media/usage-analytics/reference/response-code)。 - `message` (string) - 错误消息。 - `data` (array) - - 请求中没有填入 `uids` 字段:由指标数据和 Unix 时间戳(秒)组成的数组。 - 请求中填入了 `uids` 字段:由 `uid`、指标数据、Unix 时间戳(秒)组成的数组。 - 请求中填入了 `dimension` 和 `dimensionValues` 字段:由指标数据、维度和 Unix 时间戳(秒)组成的数组。 - `data.items` (object) ## Response examples ### 200 ```json { "code": 200, "message": "success", "data": [ { "networkDelay": 0.012, "ts": 1631837400 }, { "networkDelay": 0.0057, "ts": 1631837420 }, { "networkDelay": 0.0039, "ts": 1631837440 } ] } ```