接口功能介绍
本接口用于查询直播下行在线带宽流量数据(1分钟粒度数据)。
接口详情
请求方式:post
请求路径:/live/statistics/query-history-basic-data
使用说明
- 单个用户一分钟限制调用10000次,并发不超过100;
- 单次查询输入域名的个数不能超过100个;
- 数据延迟时间为5min;
- 该接口仅支持查询FLV和RTMP流的在线人数
请求参数
参数 | 是否必填 | 参数类型 | 说明 |
---|---|---|---|
domain | 是 | list | 域名列表 |
appname | 否 | list | 发布点列表;不传默认所有发布点 |
streamname | 否 | list | 流名列表;不传默认所有流名 |
time | 否 | int | 时间,单位秒,不传默认当前时间-3m |
响应参数
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
time | string | 否 | 查询时间点 |
totalNum | int | 否 | 总数量 |
result | list | 否 | 返回结果列表 |
result[*].Domain | string | 否 | 域名 |
result[*].App | string | 否 | 发布点 |
result[*].Stream | string | 否 | 流名 |
result[*].Online | long | 否 | 在线人数 |
result[*].Flux | double | 否 | 流量,单位:MB(按1000进制转换) |
result[*].BandWidth | double | 否 | 带宽,单位:Mbps(按1000进制转换) |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/statistics/query-history-basic-data
请求示例
{
"appname": [
"live"
],
"domain": [
"ctyun.cn"
],
"time": 1604647570
}
正常响应示例
{
"result": [
{
"App": "live",
"BandWidth": 14303,
"Flux": 858227,
"Stream": "stream4",
"Domain": "ctyun.cn",
"Online": 1
},
{
"App": "live",
"BandWidth": 14303,
"Flux": 858227,
"Stream": "stream4",
"Domain": "ctyun.cn",
"Online": 1
}
],
"code": 100000,
"totalNum": 2,
"time": "1605166620",
"message": "success"
}