接口功能介绍
支持从第三方拉流并转推到其他直播平台。
使用说明
使用第三方转推接口时，需要提供拉流和转推的完整URL。
接口详情
请求方式：POST
请求路径：/live/ext-redirect/create-ext-redirect
请求参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| DomainName | string | 域名 | 否 | - |
| App | string | 频道名 | 否 | - |
| Stream | string | 流名 | 否 | - |
| SrcUrl | String array | 任务拉流地址 | 是 | 可配置多个拉流地址任务会依次尝试，例如：["rtmp://live.pull.ctyun.cn/live/test1","rtmp://live.pull.ctyun.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 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/ext-redirect/create-ext-redirect
请求示例
{
"App":"test",
"DomainName":"ctyun.cn",
"ExtParam":{
"PullRetryTimeOut":"300",
"PullRetryType":"1"
},
"Stream":"test",
"SrcUrl":[
"rtmp://live.pull.ctyun.cn/live/test1",
"rtmp://live.pull.ctyun.cn/live/test2"
],
"DstUrl":[
"rtmp://live.push.ctyun.cn/live/test1",
"rtmp://live.push.ctyun.cn/live/test2"
]
}
正确响应示例
{
"code":100000,
"message":"success",
"taskID":"123"
}
错误码请参考: 参数code和message含义
