You need to enable JavaScript to run this app.
导航
获取离线质量数据 ListQuality
最近更新时间:2024.02.29 19:30:24首次发布时间:2022.07.08 11:35:38

你可以使用此接口查询一段时间内,某个应用的音视频通话离线质量指标数据。
若要查询地域分布、设备平台、网络类型等维度的离线质量数据,建议调用 ListQualityDistribution 接口。

使用说明

接口行为

你可以调用 ListQuality 接口,指定你所属的 AppId,指标类型和查询时间段,查询该时间段内指标的数据。

调用接口

关于调用接口的请求结构、公共参数、签名算法和返回结构,参看调用方法

注意事项

  • 最大请求次数:2次/秒
  • 最远可查询时间:30 天
  • 最大单次查询时间跨度:7 天
  • 数据粒度:1 天 或 5 分钟
  • 数据延迟:8 小时

请求说明

  • 请求方式:POST
  • 请求地址:https://rtc.volcengineapi.com?Action=ListQuality&Version=2020-12-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数名称
数据类型
是否必选
示例值
描述
Action
String
ListQuality
接口名称。当前 API 的名称为 ListQuality
Version
String
2020-12-01
接口版本。当前 API 的版本为 2020-12-01

Body

参数
类型
是否必选
示例值
描述
AppId
String
Your_AppId
你的音视频应用的唯一标志。
StartTime
String
2021-07-24T00:00:00+08:00
查询起始时间戳,格式为 RFC3339,单位为秒。
EndTime
String
2021-07-28T00:00:00+08:00
查询结束时间戳,格式为 RFC3339,单位为秒。
Indicator
String[]
["stall_rate","join_room_success_rate"]
查询的指标名称。可同时查询多个指标。Indicator 可选值,参看质量数据相关 indicator
AggregateGranularity
String
1d

返回聚合时间的粒度,支持设为以下值:

  • 1d:粒度为 1 天
  • 5min:粒度为 5 分钟
OS
String[]
["ios","linux"]

枚举值为:androidiOSlinuxmacwindows

ProductType = web 时该参数不生效
Access
String[]
["2g","3g"]
网络类型,枚举值为:2g3g4g5gwifi

ProductType = web 时该参数不生效
RoomId
String
Your_RoomId
房间 ID。如果不填,代表查询该 AppId 的整体离线指标。
UserId
String[]
Your_UserId
查询的用户 ID 列表,最多可以指定 20 个。值不合法时默认剔除。此字段仅在 RoomId 不为空时生效。
ProductType
String
native

要查询的产品类型,枚举值为 nativeweb

  • native:指 androidiOSlinuxmacwindows 平台的 veRTC SDK。
  • web:指 Web 平台的veRTC SDK。
    默认值为native

返回参数

下表仅列出本接口特有的返回参数,公共返回参数请参见返回结构

参数
类型
示例值
描述
AggregateGranularity
String
1d
返回数据的粒度
Indicators
Object[]
AudioStallDuration
具体指标数据
Name
String
5s_join_room_success_rate
指标名称
Unit
String
%
Data
Object[]
具体的指标值以及对应时间
Value
Double
99.99
指标值,浮点数,保留两位小数。指标值,浮点数,保留两位小数。
TimeStamp
String
2021-07-24T00:00:00+08:00
指标聚合时间,即指标值对应时间段的开始时刻(每 30s 一聚合)。格式为 RFC3339 规范。指标聚合时间,即指标值对应时间段的开始时刻(每 30s 一聚合)。格式为 RFC3339 规范。
overview
Object
Name
String
指标名
Unit
String
单位
Alias
String
指标中文名
Value
String
MaxValue
String
MinValue
String
ExtraInfo
String
HoverInfo
String
hover时提醒信息

请求示例

POST https://rtc.volcengineapi.com?Action=ListQuality&Version=2020-12-01

{
    "AppId" : "Your_AppId",
    "StartTime" : "2021-07-24T00:00:00+08:00",
    "EndTime" : "2021-07-28T00:00:00+08:00",
    "Indicator":["stall_rate","join_room_success_rate"],
    "ProductType":"native",
    "AggregateGranularity":"1d",
    "OS":["ios","linux"],
    "Access":["2g","3g"],
    "RoomId":"Your_RoomId",
    "UserId":"Your_UserId"     
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "Your_RequestId",
        "Action": "ListQuality",
        "Version": "2020-12-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    },
    "Result": {
        "AggregateGranularity": "1d",
        "Indicators": [
            {
                "Name": "5s_join_room_success_rate",
                "Unit": "%",
                "Data": [
                    {
                        "TimeStamp": "2021-07-24T00:00:00+08:00",
                        "Value": 98.68
                    },
                    {
                        "TimeStamp": "2021-07-25T00:00:00+08:00",
                        "Value": 98.2
                    }
                ]
            },
            {
                "Name": "10s_join_room_success_rate",
                "Unit": "%",
                "Data": [
                    {
                        "TimeStamp": "2021-07-24T00:00:00+08:00",
                        "Value": 99.68
                    },
                    {
                        "TimeStamp": "2021-07-25T00:00:00+08:00",
                        "Value": 99.2
                    }
                ]
            }
        ]
    }
}

错误码

您可访问公共错误码,获取更多错误码信息。