接口功能介绍
支持按照协议、运营商、省份、流名等不同维度查询直播带宽。
使用说明
单个用户一分钟限制调用10000次，并发不超过100。
可查询历史数据时间范围为最近14天。
单次可查询的时间跨度为3小时，时间延时为5分钟。
单次查询输入域名的个数不能超过100个。
最大返回记录50000条记录。
该接口查询的数据不作为计费依据。
接口详情
请求方式：post
请求路径：/live/statistics/query-flux-data
请求参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| start_time | long | 开始时间戳 | 是 | 起始时间，时间戳(秒)。不传或者传小于等于0是默认取当前时间-3分钟 |
| end_time | long | 结束时间戳 | 是 | 结束时间，时间戳(秒)。不传或者传小于等于0默认取start_time + 1分钟 |
| interval | string | 时间粒度 | 否 | 时间粒度，目前限制1m，不传默认1m |
| domain | list | 域名列表 | 否 | 域名，不传默认名下所有域名，可多个域名，且域名的个数不超过100个。 |
| app | list | 应用名列表 | 否 | 应用名，默认名下所有应用名，可多个应用名 |
| stream | list | 流名列表 | 否 | 流名，默认名下所有流名，可多个流名 |
| province | list | 省编码列表 | 否 | 省编码列表，不传默认所有省份，点击查看省份及对应的省编码。 |
| isp | list | 运营商编码列表 | 否 | 运营商编码，不传默认所有运营商，可多个运营商编码作为统计筛选项，点击查看运营商及对应的运营商编码。 |
| protocol | list | 应用层协议列表 | 否 | 应用层协议，不传默认所有络层协议，支持作为统计筛选项，可以为rtmp、http、https。 |
| live_type | list | 直播协议类型列表 | 否 | 播放协议，支持rtmp，flv，hls，other，不传默认所有播放协议，作为统计过滤项。 |
| group_by | list | 聚合维度 | 否 | 该指标统计结果的聚合维度，支持在时间颗粒度外叠加多种聚合维度。目前支持domain，app，province，isp，stream，province，isp，protocol，live_type。不传默认统计结果按时间颗粒维度聚合。 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| message | string | 描述信息 |
| start_time | int | 开始时间戳 |
| end_time | int | 结束时间戳 |
| interval | string | 时间粒度 |
| req_flux_data_interval | list | 每个时间间隔的在线人数 |
| req_flux_data_interval[*].time_stamp | int | 时间片开始时间戳 |
| req_flux_data_interval[*].domain | string | 域名 |
| req_flux_data_interval[*].app | string | 应用名 |
| req_flux_data_interval[*].stream | string | 流名 |
| req_flux_data_interval[*].province | int | 省编码 |
| req_flux_data_interval[*].isp | string | 运营商编码 |
| req_flux_data_interval[*].protocol | string | 应用层协议 |
| req_flux_data_interval[*].live_type | string | 播放协议 |
| req_flux_data_interval[*].flux | long | 流量，单位为字节 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/statistics/query-flux-data
请求示例
{
"start_time": 1669257052,
"end_time": 1669264252,
"domain": ["ctyun.cn"],
"group_by": ["domain","protocol"]
}
正确响应示例
{
"start_time": 1669257052,
"code": 100000,
"req_flux_data_interval": [
{
"protocol": "https",
"time_stamp": 1669257960,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669257960,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669257960,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "https",
"time_stamp": 1669258140,
"domain": "ctyun.cn",
"flux": 3980210
},
{
"protocol": "rtmp",
"time_stamp": 1669258140,
"domain": "ctyun.cn",
"flux": 3956797
},
{
"protocol": "http",
"time_stamp": 1669258140,
"domain": "ctyun.cn",
"flux": 3652428
},
{
"protocol": "rtmp",
"time_stamp": 1669258320,
"domain": "ctyun.cn",
"flux": 2083757
},
{
"protocol": "https",
"time_stamp": 1669258320,
"domain": "ctyun.cn",
"flux": 2247648
},
{
"protocol": "http",
"time_stamp": 1669258320,
"domain": "ctyun.cn",
"flux": 2060344
},
{
"protocol": "https",
"time_stamp": 1669258500,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669258500,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669258500,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "https",
"time_stamp": 1669258680,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669258680,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669258680,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669258860,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669258860,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "https",
"time_stamp": 1669258860,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669260660,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669260660,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "https",
"time_stamp": 1669260660,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "https",
"time_stamp": 1669262460,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "http",
"time_stamp": 1669262460,
"domain": "ctyun.cn",
"flux": 1685736
},
{
"protocol": "rtmp",
"time_stamp": 1669262460,
"domain": "ctyun.cn",
"flux": 1685736
}
],
"end_time": 1669264252,
"interval": "1m",
"message": "success"
}
错误码请参考：参数code和message含义
