直播流狀態查詢
更新時間 2023-12-08 10:34:04
最近更新時間: 2023-12-08 10:34:04
分享文章
接口功能介紹
通過本接口可查詢流的在線狀態。
使用說明
單個用戶一分鐘限制調用10000次，并發不超過100。
接口詳情
請求方式：POST
請求路徑：/live/statistics/query-stream-status
請求參數
| 參數 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| domain | string | 域名 | 是 | - |
| app | string | 發布點 | 否 | 不傳或傳空默認返回所有 |
| stream | string | 流名 | 否 | 不傳或傳空默認返回所有 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼 |
| message | string | 描述信息 |
| total_num | int | 總數量 |
| result | list | 返回結果列表 |
| result[*].heart_time | string | 最新時間 |
| result[*].domain | string | 域名 |
| result[*].app | string | 應用名稱 |
| result[*].stream | string | 流名稱 |
| result[*].online | string | 流狀態。取值0和1；0表示查詢的流已經結束推流，1表示當前在線流 |
| result[*].start_time | string | 推流開始時間 |
| result[*].client_ip | string | 主播推流端IP |
| result[*].server_ip | string | cdn推流節點IP |
示例
請求路徑：//cdnapi-global.ctapi.daliqc.cn/live/statistics/query-stream-status
請求示例
{
"app": "app-a",
"stream": "stream-a",
"domain": "daliqc.cn"
}
正常響應示例
{
"code": 100000,
"message": "success",
"total_num": 1,
"result": [
{
"app": "app-a",
"start_time": "1617850720.201",
"stream": "stream-a",
"heart_time": "1617850799.221",
"domain": "daliqc.cn",
"server_ip": "36.111.140.1",
"online": "1",
"client_ip": "36.111.140.2"
}
]
}
錯誤碼請參考：參數code和message含義
