实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频服务端 API 参考实时数据监控获取实时 WTN 流订阅数据 ListRealTimePublicStreamInfo
复制全文
下载 pdf获取实时 WTN 流订阅数据 ListRealTimePublicStreamInfo
文档反馈
问问助手调用 ListRealTimePublicStreamInfo 查询一段时间内指定应用的 WTN 流订阅数据。
使用说明
指标聚合时间为 30s，若查询间隔包含第 0 s 或 30 s，会返回对应时间点的数据，否则为空。
注意事项
- 最大请求次数：10 次/秒
- 最远可查询时间：30 天
- 最大单次查询时间跨度：120 分钟
- 数据延迟：60 秒
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=ListRealTimePublicStreamInfo&Version=2023-11-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：ListRealTimePublicStreamInfo
接口名称。当前 API 的名称为 ListRealTimePublicStreamInfo。
Version String 必选 示例值：2023-11-01
接口版本。当前 API 的版本为 2023-11-01。
Body
AppId String 必选 示例值：66****3cf
StreamId String 可选 示例值：stream1
要查询的 WTN 流 ID，多个 ID 用逗号隔开。
若不填则查询当前 AppId 下所有 WTN 流。
StartTime String 必选 示例值：2024-11-07T00:00:00+08:00
查询起始时间戳，格式为 RFC3339。
EndTime String 必选 示例值：2024-11-08T00:00:00+08:00
查询结束时间戳，格式为 RFC3339。
Indicator String[] 必选 示例值：["pull_num"]
查询的指标名称，目前仅支持 pull_num（订阅数）
返回参数
Indicators Object[]
WTN 流指标详细信息。
Name String 示例值：pull_num
指标名称。
Unit String 示例值：-
指标单位。
Data Object[] 示例值：-
指标详细数据。
Value Double 示例值：99.99
指标值，浮点数，保留两位小数。
TimeStamp String 示例值：2021-07-24T00:00:00+08:00
指标聚合时间，即指标值对应时间段的开始时刻（每 30s 一聚合）。格式为 RFC3339 规范。
StreamId String 示例值：stream1
流 ID。
请求示例
POST https://rtc.volcengineapi.com?Action=ListRealTimePublicStreamInfo&Version=2023-11-01
{
"AppId": "66****3cf",
"StartTime": "2024-11-11T10:00:00+08:00",
"EndTime": "2024-11-11T12:00:00+08:00",
"Indicator": ["pull_num"],
"StreamId": "steam1"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "0217319067ee00f6f",
"Action": "ListRealTimePublicStreamInfo",
"Version": "2023-11-01",
"Service": "rtc",
"Region": "cn-north-1"
},
"Result": {
"Indicators": [
{
"Name": "pull_num",
"Unit": "",
"Data": [
{
"TimeStamp": "2024-11-11T10:00:00+08:00",
"Value": 1,
"StreamId": "AC22010021123"
},
{
"TimeStamp": "2024-11-11T10:00:30+08:00",
"Value": 1,
"StreamId": "AC22010021123"
}
]
}
]
}
}
错误码
最近更新时间：2026.08.19 18:26:14
这个页面对您有帮助吗？
有用
有用
无用
无用