实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频服务端 API 参考历史数据查询获取通话时长数据 ListUsages
复制全文
下载 pdf获取通话时长数据 ListUsages
文档反馈
问问助手调用 ListUsages 获取特定应用在指定时间段内的通话时长数据。数据以天为单位进行汇总。
由于汇总粒度不同，此处获取的数据和账单通话时长数据差异。最终数据以账单数据为准。
注意事项
- 最大请求次数：2次/秒
- 最远可查询时间：30 天
- 数据粒度：1 天
- 数据延迟：8 小时
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=ListUsages&Version=2024-03-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：ListUsages
接口名称。当前 API 的名称为 ListUsages。
Version String 必选 示例值：2024-03-01
接口版本。当前 API 的版本为 2024-03-01。
Body
AppId String 必选 示例值：66****3cf
StartTime String 必选 示例值：2021-07-24T00:00:00+08:00
查询数据的开始时间，格式要求符合 RFC3339 规范，单位为秒。
EndTime String 必选 示例值：2021-07-28T00:00:00+08:00
查询数据的结束时间，格式要求符合 RFC3339 规范。起止时间的跨度最多为 30 天。
返回参数
Usages Object[] 示例值：-
通话时长数据。
Audio Long 示例值：123456
计价档位为纯音频的通话时长，单位为分钟。
VideoHD Long 示例值：123456
计价档位为 1080P 视频的通话时长，单位为分钟。
VideoSD Long 示例值：123456
计价档位为 720P 视频的通话时长，单位为分钟。
VideoSDM Long 示例值：123456
计价档位为 360P 视频的通话时长，单位为分钟。
TimeStamp String 示例值：2021-07-24T00:00:00+08:00
指标聚合的时间，格式为 RFC3339 规范。这个参数的值，指通话时长对应时间段的开始时刻。以示例值为例，意味着对应的时间段为 北京时间 2021 年 7 月 24 日 0 点起的 1 天。
Video2K Long 示例值：123456
计价档位为 2K 视频的通话时长，单位为分钟。
Video4K Long 示例值：123456
计价档位为 4K 视频的通话时长，单位为分钟。
请求示例
POST https://rtc.volcengineapi.com?Action=ListUsages&Version=2024-03-01
{
"AppId": "66****3cf",
"StartTime": "2021-07-24T08:00:00+08:00",
"EndTime": "2021-07-28T08:00:00+08:00"
}
返回示例
{
"ResponseMetadata":{
"RequestId":"20230604110420",
"Action":"ListUsages",
"Version":"2020-12-01",
"Service":"rtc",
"Region":"cn-north-1"
},
"Result":{
"Usages":[
{
"TimeStamp":"2021-07-24T00:00:00+08:00",
"Audio":12345,
"VideoSDM":123456,
"VideoSD":11111,
"VideoHD":12321,
"Video2K":11111,
"Video4K":12321
},
{
"TimeStamp":"2021-07-25T00:00:00+08:00",
"Audio":12345,
"VideoSDM":123456,
"VideoSD":11111,
"VideoHD":12321,
"Video2K":11111,
"Video4K":12321
}
]
}
}
错误码
最近更新时间：2026.08.19 18:32:18
这个页面对您有帮助吗？
有用
有用
无用
无用