創建直播第三方轉推任務
更新時間 2023-12-27 14:27:54
最近更新時間: 2023-12-27 14:27:54
分享文章
接口功能介紹
支持從第三方拉流并轉推到其他直播平臺。
使用說明
使用第三方轉推接口時,需要提供拉流和轉推的完整URL。
接口詳情
請求方式:POST
請求路徑:/live/ext-redirect/create-ext-redirect
請求參數
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| DomainName | string | 域名 | 否 | - |
| App | string | 頻道名 | 否 | - |
| Stream | string | 流名 | 否 | - |
| SrcUrl | String array | 任務拉流地址 | 是 | 可配置多個拉流地址任務會依次嘗試,例如:["rtmp://live.pull.daliqc.cn/live/test1","rtmp://live.pull.daliqc.cn/live/test2"] |
| DstUrl | string | 任務推流地址 | 是 | - |
| ExtParam | object | 擴展參數配置 | 否 | 見下方 |
| ExtParam.PullRetryType | string | 拉流重試方式 | 否 | 有兩種類型,分別是: “0”,不重試,默認值 “1”,按時長重試,時長通過PullRetryTimeOut設置 只能傳“0”和“1”。 |
| ExtParam.PullRetryTimeOut | string | 拉流轉推重試時長 | 否 | PullRetryType 為“1”時生效,表示所有源流都不存在拉流轉推重試時長,默認10分鐘,單位s |
響應參數
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼,成功時為100000 |
| message | string | 描述信息,成功時為success |
| TaskID | string | 任務id |
示例
請求路徑://cdnapi-global.ctapi.daliqc.cn/live/ext-redirect/create-ext-redirect
請求示例
{
"App":"test",
"DomainName":"daliqc.cn",
"ExtParam":{
"PullRetryTimeOut":"300",
"PullRetryType":"1"
},
"Stream":"test",
"SrcUrl":[
"rtmp://live.pull.daliqc.cn/live/test1",
"rtmp://live.pull.daliqc.cn/live/test2"
],
"DstUrl":[
"rtmp://live.push.daliqc.cn/live/test1",
"rtmp://live.push.daliqc.cn/live/test2"
]
}
正確響應示例
{
"code":100000,
"message":"success",
"taskID":"123"
}
錯誤碼請參考: 參數code和message含義