查詢發布點/流名粒度配置
更新時間 2023-11-10 10:42:16
最近更新時間: 2023-11-10 10:42:16
分享文章
接口功能介紹
查詢指定域名的發布點、流名粒度配置。
接口詳情
請求方式:POST
請求路徑:/live/app-and-stream/query-app-and-stream
請求參數
| 參數 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| product_code | string | 產品類型 | 是 | 支持:“005”(視頻直播) |
| domain | string | 域名 | 是 | 加速域名 |
響應參數
| 參數 | 類型 | 說明 | 下級對象 |
|---|---|---|---|
| code | int | 狀態碼,成功100000 | |
| message | string | 信息描述,成功返回success,其他返回異常信息描述 | |
| product_code | string | 產品類型,支持:“005”(視頻直播) | |
| domain | string | 加速域名 | |
| apps_conf | list | 發布點配置 | apps_conf_single |
| streams_conf | list | 流名配置 | streams_conf_single |
apps_conf_single
| 參數 | 類型 | 說明 | 下級對象 |
|---|---|---|---|
| id | string | 發布點配置ID | |
| app_name | string | 發布點,一次只能提交1個頻道名 支持精確匹配和模糊匹配(支持字母、數字、-、,但不能直接傳“”),長度限制為128個字符 |
|
| third_push | object | 轉推任務,只支持配置一個轉推任務,當前只支持綁定推流域名 | third_push |
| time_shift | object | 時移任務,只支持配置一個時移任務,當前只支持綁定推流域名 | time_shift |
streams_conf_single
| 參數 | 類型 | 說明 | 下級對象 |
|---|---|---|---|
| id | string | 流名配置ID | |
| app_name | string | 發布點 | |
| stream_name | string | 流名稱 | |
| third_push | object | 轉推任務,只支持配置一個轉推任務,當前只支持綁定推流域名 | third_push |
| time_shift | object | 時移任務,只支持配置一個時移任務,當前只支持綁定推流域名 | time_shift |
third_push
| 參數 | 類型 | 說明 | 下級對象 |
|---|---|---|---|
| switch | string | 轉推開關,on(開啟)、off(關閉) | |
| push_list | list | 轉推列表,開關開啟時必填 | push_list_single |
push_list_single
| 參數 | 類型 | 說明 |
|---|---|---|
| origin | string | 轉推目標ip或域名,支持ipv4、ipv6和域名 |
| port | string | 轉推目標端口,不填默認1935 |
| host | string | 轉推使用的請求頭host |
time_shift
| 參數 | 類型 | 說明 |
|---|---|---|
| switch | string | 時移開關,on(開啟)、off(關閉) |
| max_playback_time | string | 時移任務回看時長,30s~30d(time格式,30s到30天); 默認一小時,支持的單位: s、m、 h、d |
| module_id | string | 錄制模板id,時移需要綁定的錄制模板id |
示例
請求路徑://cdnapi-global.ctapi.daliqc.cn/live/app-and-stream/query-app-and-stream
請求示例
{
"product_code": "005",
"domain": "daliqc.cn"
}
正常響應示例
{
"code": 100000,
"message": "success",
"product_code": "005",
"domain": "push.daliqc.cn",
"apps_conf": [
{
"id": "3d28337",
"app_name": "app-5"
},
{
"id": "34e11a897e2",
"app_name": "app3343",
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "1.1.1.1",
"port": "11",
"host": "daliqc.cn1"
},
{
"origin": "2.1.1.1",
"port": "11",
"host": "daliqc.cn2"
}
]
},
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d656acd5"
}
}
],
"streams_conf": [
{
"id": "a3915a86b7c",
"app_name": "app-6",
"stream_name": "fff444"
},
{
"id": "e028077f8",
"app_name": "app-6",
"stream_name": "fffd",
"third_push": {
"switch": "on",
"push_list": [
{
"origin": "111.12.1.1",
"port": "11",
"host": "daliqc.cn3"
}
]
},
"time_shift": {
"switch": "on",
"max_playback_time": "32s",
"module_id": "d656eacd5"
}
}
]
}
錯誤碼請參考:參數code和message含義