- 接口描述：
调用本接口查询某一段时间内直播实时传输的视频帧率和视频码率，且可根据域名，应用名，流名，省份，运营商进行筛选。 - 使用说明：
单个用户一分钟限制调用10000次，并发不超过100。最多支持历史14天数据的查询，接口查询范围最大为14天，时间延时为1分钟。 - 请求方式：
post - 请求路径：
/v1/live_data_statistics/query_stream_status_info
请求参数说明
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| time | int | 查询时间戳 | 否 | 起始时间，时间戳(秒)，查询范围是time-59S至time，若不传默认查询当前时间-240s至当前时间。 |
| domain | list | 域名列表 | 是 | 域名，可多个域名 |
| app | list | 应用名列表 | 否 | 应用名，默认名下所有应用名，可多个应用名 |
| stream | list | 流名列表 | 否 | 流名，默认名下所有流名，可多个流名 |
| province | list | 省编码列表 | 否 | 省编码，默认所有省份，可多个省编码，省份及对应的省编码点击查看 |
| isp | list | 运营商编码列表 | 否 | 运营商编码，默认所有运营商，可多个运营商编码，运营商及对应的运营商编码点击查看 |
| group_by | list | 聚合维度 | 是 | 指标在计算结果的聚合维度，目前必传固定值[“domain”,“app”,“stream”]。后续（2022年7月26日后）该指标为非必传，默认时按时间维度聚合，且可自行选择叠加的统计维度，支持的维度包括域名，应用名，流名，省编码，运营商编码。 |
返回参数说明
| 参数名 | 类型 | 名称 | 说明 |
|---|---|---|---|
| code | int | 状态码 | |
| message | string | 描述信息 | 调用成功/错误的描述 |
| req_stream_status_info | list | 直播流状态信息数据列表 | |
| req_stream_status_info [*].domain | string | 域名 | |
| req_stream_status_info [*].app | string | 应用名 | |
| req_stream_status_info [*].stream | string | 流名 | |
| req_stream_status_info [*].video_fps | int | 实时传输的视频帧率 | |
| req_stream_status_info [*].video_bitrate | int | 实时传输的视频码率 |
正确调用示例
https://open.ctcdn.cn/api/v1/live_data_statistics/query_stream_status_info
请求参数：
{
"time": 1655345580,
"domain": [
"xxx.test.www.ctyun.cn"
],
"app": [
"live875"
],
"stream": [
"testlive1655708999875"
],
"province": [
440000
],
"isp": [
"001"
],
"group_by": [
"domain",
"app",
"stream"
]
}
返回结果：
{
"code": 100000,
"message": "success",
"req_stream_status_info": [
{
"domain": "xxx.test.www.ctyun.cn",
"app": "live875",
"stream": "testlive1655708999875",
"province": 440000,
"video_fps": 150,
"video_bitrate": 2176
}
]
}
错误调用示例
https://open.ctcdn.cn/api/v1/live_data_statistics/query_stream_status_info
请求参数：
{
"domain": [
"abc.com"
]
}
返回结果：
{
"code": 110002,
"message": "当前用户对域名ID或域名abc.com无权限"
}
