查詢直播帶寬
更新時間 2024-06-24 15:42:51
最近更新時間: 2024-06-24 15:42:51
分享文章
接口功能介紹
支持按照協議、運營商、省份、流名等不同維度查詢直播帶寬。
使用說明
單個用戶一分鐘限制調用10000次，并發不超過100。
可查詢歷史數據時間范圍為最近14天。
單次可查詢的時間跨度為3小時，時間延時為5分鐘。
單次查詢輸入域名的個數不能超過100個。
最大返回記錄50000條記錄。
該接口查詢的數據不作為計費依據。
接口詳情
請求方式：post
請求路徑：/live/statistics/query-bandwidth-data
請求參數
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| 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，hls，other，不傳默認所有播放協議，作為統計過濾項。 |
| group_by | list（string） | 聚合維度 | 否 | 該指標統計結果的聚合維度，支持在時間顆粒度外疊加多種聚合維度。目前支持domain，app，province，isp，stream，province，isp，protocol，live_type。不傳默認統計結果按時間顆粒維度聚合。 |
響應參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼 |
| message | string | 描述信息 |
| start_time | int | 開始時間戳 |
| end_time | int | 結束時間戳 |
| interval | string | 時間粒度 |
| req_bandwidth_data_interval | list | 每個時間間隔的在線人數 |
| req_bandwidth_data_interval [*].time_stamp | int | 時間片開始時間戳 |
| req_bandwidth_data_interval [*].domain | string | 域名 |
| req_bandwidth_data_interval [*].app | string | 應用名 |
| req_bandwidth_data_interval [*].stream | string | 流名 |
| req_bandwidth_data_interval [*].province | int | 省編碼 |
| req_bandwidth_data_interval [*].isp | string | 運營商編碼 |
| req_bandwidth_data_interval [*].protocol | string | 應用層協議 |
| req_bandwidth_data_interval[*].live_type | string | 直播協議類型 |
| req_bandwidth_data_interval [*].bandwidth | long | 帶寬，單位為bps |
示例
請求路徑：//cdnapi-global.ctapi.daliqc.cn/live/statistics/query-bandwidth-data
請求示例
{
"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_bandwidth_data_interval": [
{
"time_stamp": 1655709000,
"domain": "daliqc.cn",
"app": "live875",
"stream": "testlive1655708999875",
"province": 440000,
"isp": "001",
"bandwidth": 3121
}
]
}
錯誤碼請參考: 參數code和message含義
