接口功能介绍
调用本接口查询某一段时间内直播推流并发数。
使用说明
单个用户一分钟限制调用10000次,并发不超过100。
可查询历史数据时间范围为最近14天。
单次可查询的时间跨度为3小时。
单次查询输入域名的个数不能超过100个。
最大返回记录50000条记录。
接口详情
请求方式:post
请求路径:/live/statistics/query-concurrency-data
请求参数
参数 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
start_time | int | 开始时间戳 | 是 | 起始时间,时间戳(秒) |
end_time | int | 结束时间戳 | 是 | 结束时间,时间戳(秒) |
interval | string | 时间粒度 | 否 | 时间粒度,只支持1m,默认1m |
domain | list | 域名列表 | 是 | 域名,可多个域名 |
app | list | 应用名列表 | 否 | 应用名,默认名下所有应用名,可多个应用名 |
stream | list | 流名列表 | 否 | 流名,默认名下所有流名,可多个流名 |
province | list | 省编码列表 | 否 | 省编码,默认所有省份,可多个省编码,省份及对应的省编码点击查看 |
isp | list | 运营商编码列表 | 否 | 运营商编码,默认所有运营商,可多个运营商编码,运营商及对应的运营商编码点击查看 |
响应参数
参数 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
message | string | 调用成功/错误的描述 |
start_time | int | 开始时间戳 |
end_time | int | 结束时间戳 |
interval | string | 时间粒度 |
req_concurrency_data_interval | list | 每个时间间隔的推流并发数 |
req_concurrency_data_interval[*].time_stamp | int | 时间片开始时间戳 |
req_concurrency_data_interval[*].domain | string | 域名 |
req_concurrency_data_interval[*].value | long | 并发数 |
示例
https://cdnapi-global.ctapi.ctyun.cn/live/statistics/query-concurrency-data
请求示例
{
"start_time": 1655704800,
"end_time": 1655712000,
"interval": "1m",
"domain": [
"ctyun.cn"
],
"app": [
"live875"
],
"stream": [
"testlive1655708999875"
],
"province": [
440000
],
"isp": [
"001"
]
}
正常响应示例
{
"code": 100000,
"message": "success",
"start_time": 1655704800,
"end_time": 1655712000,
"interval": "1m",
"req_concurrency_data_interval": [
{
"time_stamp": 1655709000,
"domain": "ctyun.cn",
"value": 31
}
]
}