接口功能介绍
调用本接口查询直播TopN在线人数的流详情
使用说明
单个用户一分钟限制调用10000次,并发不超过100
该接口仅支持查询FLV和RTMP流的在线人数
接口详情
请求方式:POST
请求路径:/live/statistics/query-stream-top-online-num
请求参数
参数 | 类型 | 是否必传 | 名称 | 描述 |
---|---|---|---|---|
domain | list | 是 | 域名列表 | 可多个域名,作为统计筛选项 |
appname | list | 否 | 应用列表 | 不填默认所有应用 |
time | int | 否 | 开始时间 | 不填默认当前时间-3min |
top_rank | int | 否 | 倒序取top_rank条数据 | 不填默认100 |
响应参数
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
totalNum | int | 否 | 总数量 |
result | list | 否 | 返回结果列表 |
result[*].Domain | string | 否 | 域名 |
result[*].App | string | 否 | 应用名称 |
result[*].Stream | string | 否 | 流名称 |
result[*].Online | int | 否 | 在线人数 |
result[*].Time | int | 否 | 回传参数的Time值 |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/statistics/query-stream-top-online-num
请求示例
{
"domain": [
"ctyun.cn"
],
"time": 1608530340
}
正常响应示例
{
"result": [
{
"App": "live1",
"Stream": "stream5",
"Time": 1608530340,
"Domain": "ctyun.cn",
"Online": 1
}
],
"code": 100000,
"totalNum": 1,
"message": "success"
}
错误码请参考:参数code和message含义