You need to enable JavaScript to run this app.
文档中心
实时音视频

实时音视频

复制全文
下载 pdf
实时数据监控
获取实时运营数据 ListRealTimeOperationData
复制全文
下载 pdf
获取实时运营数据 ListRealTimeOperationData
本文档 API 接口为最新版本接口,后续相关功能的新增都会在此更新,推荐使用最新版本接口。旧版接口文档请参考历史版本。​
调用 ListRealTimeOperationData 查询特定应用在设定时间段内的实时运营数据。可查询指标数据参见 实时运营数据相关 indicator。​
注意事项​
  • 最大请求次数:2 次/秒​
  • 最远可查询时间:60 分钟​
  • 最大单次查询时间跨度:60 分钟​
  • 数据延迟:20 秒​
请求说明​
  • 请求方式:POST​
  • 请求地址:https://rtc.volcengineapi.com?Action=ListRealTimeOperationData&Version=2023-11-01​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Query​
Action String 必选 示例值:ListRealTimeOperationData​
接口名称。当前 API 的名称为 ListRealTimeOperationData。​
​
Version String 必选 示例值:2023-11-01​
接口版本。当前 API 的版本为 2023-11-01。​
​
​
Body​
AppId String 必选 示例值:66****3cf​
实时音视频应用的 AppId。可在控制台获取。​
​
StartTime String 必选 示例值:2021-07-24T00:00:00+08:00​
查询起始时间戳,格式为 RFC3339。​
​
EndTime String 必选 示例值:2021-07-24T00:01:00+08:00​
查询结束时间戳,格式为 RFC3339。​
​
Indicator String[] 必选 示例值:["online_user_count","online_room_count"]​
要查询的指标名称,可同时查询多个。Indicator 支持取值参见实时运营数据相关 indicator。​
​
​
返回参数​
下表仅列出本接口特有的返回参数,公共返回参数请参见返回结构。​
Indicators Object[] 示例值:-​
指标信息。​
Data Object[] 示例值:-​
指标详细数据。​
Value Double 示例值:99.99​
指标值,浮点数,保留两位小数。​
​
TimeStamp String 示例值:2021-07-24T00:00:00+08:00​
指标聚合时间,即指标值对应时间段的开始时刻(每 30s 一聚合)。格式为 RFC3339 规范。​
​
StreamId String 示例值:stream1​
流 ID。​
​
​
Name String 示例值:pull_num​
指标名称。​
​
​
​
请求示例​
​
POST https://rtc.volcengineapi.com?Action=ListRealTimeOperationData&Version=2023-11-01​
{​
"AppId": "661e7ae5543cf",​
"StartTime": "2021-07-24T00:00:00+08:00",​
"EndTime": "2021-07-24T00:01:00+08:00",​
"Indicator": [​
"online_user_count",​
"online_room_count"​
]​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420",​
"Action": "ListRealTimeOperationData",​
"Version": "2023-11-01",​
"Service": "rtc",​
"Region": "cn-north-1"​
},​
"Result": {​
"Indicators": [​
{​
"Name": "online_user_count",​
"Data": [​
{​
"TimeStamp": "2021-07-24T00:00:00+08:00",​
"Value": 3212​
},​
{​
"TimeStamp": "2021-07-24T00:00:30+08:00",​
"Value": 3211​
},​
{​
"TimeStamp": "2021-07-24T00:01:00+08:00",​
"Value": 3210​
}​
]​
},​
{​
"Name": "online_room_count",​
"Data": [​
{​
"TimeStamp": "2021-07-24T00:00:00+08:00",​
"Value": 1231​
},​
{​
"TimeStamp": "2021-07-24T00:00:30+08:00",​
"Value": 1232​
},​
{​
"TimeStamp": "2021-07-24T00:01:00+08:00",​
"Value": 1233​
}​
]​
}​
]​
}​
}​
​
错误码​
您可访问公共错误码,获取更多错误码信息。​
最近更新时间:2026.08.19 17:33:07
这个页面对您有帮助吗?
有用
有用
无用
无用