查詢直播在線人數
更新時間 2024-06-11 15:41:26
最近更新時間: 2024-06-11 15:41:26
分享文章
接口功能說明
支持查詢一段時間內的直播在線人數。
使用說明
單個用戶一分鐘限制調用10000次，并發不超過100
可查詢歷史數據時間范圍為最近14天。
單次可查詢的時間跨度為3小時，時間延時為1分鐘。
單次查詢輸入域名的個數不能超過100個
最大返回記錄50000條記錄。
該接口僅支持查詢FLV和RTMP流的歷史在線人數
接口詳情
請求方式：post
請求路徑：/live/statistics/query-online-num
請求參數
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| start_time | long | 開始時間戳 | 是 | 起始時間，時間戳(秒)。不傳或者傳小于等于0是默認取當前時間-3分鐘 |
| end_time | long | 結束時間戳 | 是 | 結束時間，時間戳(秒)。不傳或者傳小于等于0默認取start_time + 1分鐘 |
| interval | string | 時間粒度 | 否 | 時間粒度，目前限制1m，不傳默認1m |
| domain | list（string） | 域名列表 | 否 | 域名，不傳默認名下所有域名，可多個域名，且域名的個數不超過100個。 |
| app | list（string） | 應用名列表 | 否 | 應用名，默認名下所有應用名，可多個應用名 |
| stream | list（string） | 流名列表 | 否 | 流名，默認名下所有流名，可多個流名 |
| province | list（int） | 省編碼列表 | 否 | 省編碼列表，不傳默認所有省份，點擊查看省份及對應的省編碼。 |
| isp | list（string） | 運營商編碼列表 | 否 | 運營商編碼列表，不傳默認所有運營商，點擊查看運營商及對應運營商編碼。 |
| protocol | list（string） | 播放協議列表 | 否 | 應用層協議列表，不傳默認所有絡層協議，可以為rtmp、http、https。 |
| live_type | list（string） | 播放協議列表 | 否 | 播放協議列表，不傳默認所有播放協議，支持rtmp，flv |
| group_by | list（string） | 聚合維度 | 否 | 該指標統計結果的聚合維度，支持在時間顆粒度外疊加多種聚合維度。目前支持domain，app，province，isp，stream，province，isp，protocol。不傳默認統計結果按時間顆粒維度聚合。 |
響應參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼 |
| message | string | 描述信息 |
| start_time | int | 開始時間戳 |
| end_time | int | 結束時間戳 |
| interval | string | 時間粒度 |
| req_online_num_interval | list | 每個時間間隔的在線人數 |
| req_online_num_interval[*].time_stamp | int | 時間片開始時間戳 |
| req_online_num_interval[*].domain | string | 域名 |
| req_online_num_interval[*].app | string | 應用名 |
| req_online_num_interval[*].stream | string | 流名 |
| req_online_num_interval[*].province | int | 省編碼 |
| req_online_num_interval[*].isp | string | 運營商編碼 |
| req_online_num_interval[*].protocol | string | 應用層協議 |
| req_online_num_interval[*].live_type | string | 直播協議類型 |
| req_online_num_interval[*].online | long | 在線人數 |
示例
請求路徑：//cdnapi-global.ctapi.daliqc.cn/live/statistics/query-online-num
請求示例
{
"start_time": 1655704800,
"end_time": 1655712000,
"interval": "1m",
"domain": [
"daliqc.cn"
],
"app": [
"live875"
],
"stream": [
"testlive1655708999875"
],
"province": [
440000
],
"isp": [
"001"
],
"group_by": [
"domain",
"app",
"stream",
"province",
"isp"
]
}
正常響應示例
{
"code": 100000,
"message": "success",
"start_time": 1655704800,
"end_time": 1655712000,
"interval": "1m",
"req_online_num_interval": [
{
"time_stamp": 1655709000,
"domain": "daliqc.cn",
"app": "live875",
"stream": "testlive1655708999875",
"province": 440000,
"isp": "001",
"online": 109
}
]
}
錯誤碼請參考：參數code和message含義
