视频直播

产品文档

视频直播

帮助中心 > OpenAPI & SDK > 视频直播 > 创建拉流转推任务

createLiveForwardTask

描述

创建直播拉流转推任务

请求方式

POST

请求地址

https://live.jdcloud-api.com/v1/LiveForwardTask:create

请求参数

名称 类型 是否必需 默认值 描述
sourceUrl String True 拉流地址
- 支持rtmp
pushUrl String True 转推地址
- 支持rtmp
startMode String True 执行方式
- StartNow: 立即执行
- StartAsScheduled: 定时执行,根据参数设定的时间
startTime String False 开始时间
- UTC时间, ISO8601示例:2021-07-26T08:08:08Z
- 不填表示立即开始
endTime String False 结束时间
- UTC时间, ISO8601示例:2021-07-26T08:08:08Z
- 最大支持365天,与开始时间间隔不超过7天。
- 假设当前时间2021年03月30日11:50:01,则:结束时间不可超过2022年03月30日11:50:01。
- 不填拉不到流10分钟自动结束
callbackEvents String[ ] False 回调类型
- 不填发送全部回调
- TaskStart 任务开始
- TaskExit 任务结束
- callbackUrl非空的情况下,callbackEvents有效
callbackUrl String False 事件回调地址
name String False 任务名称
- 最大255字符

返回参数

名称 类型 描述
result Result
requestId String requestId

Result

名称 类型 描述
taskId String 任务ID

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
500 Internal server error
503 Service unavailable

请求示例

POST

https://live.jdcloud-api.com/v1/LiveForwardTask:create

{
    "callbackEvents": [
        "TaskExit"
    ], 
    "callbackUrl": "http://127.0.0.1", 
    "endTime": "2021-08-26T09:00:00Z", 
    "name": "test", 
    "pushUrl": "rtmp://127.0.0.1", 
    "sourceUrl": "rtmp://127.0.0.1", 
    "startMode": "StartAsScheduled", 
    "startTime": "2021-08-20T12:00:00Z"
}

返回示例

{
    "code": 200, 
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "taskId": "9"
    }
}
更新时间:2021-12-09 14:57:51
feedback