创建拉流配置

创建拉流配置

API 地址

api.vhallyun.com/api/v2/room/create-live-pull-stream-config

描述

根据源流(url或vhall房间ID) 、拉流的目标房间(vhall房间ID)、开始时间、结束时间创建直播拉流配置,创建完成后将按照开始/结束时间执行任务。

回调事件类型: 直播拉流事件

入参

关于公共请求参数详细内容,请参考 公共请求参数。

参数 类型 是否必选 含义
room_id string 是 拉流房间ID
source_type int 是 标识拉流来源类型
0:第三方URL类型
1:vhall直播间类型
source_url string 是 来源的视频流URL
支持rtmp,http格式
(当source_type为0的类型会校验url正确性,其他类型时字段值可以为空)
source_room_id string 是 来源的vhall直播房间ID
(当source_type为1的类型会校验来源房间正确性,其他类型时字段值可以为空)
start_time string 是 拉流开始时间,格式如2019-01-01 12:00:00
end_time string 是 拉流结束时间,格式如2019-01-02 12:00:00
结束时间和开始时间必须大于当前时间
拉流结束时间和开始时间间隔在 5 天内,且结束时间要大于开始时间

出参

参数 类型 是否必选 含义
config_id string 是 拉流配置ID

错误码

错误码 类型 含义
10008 int 房间ID不能为空
10082 int 拉流来源类型不能为空
20002 int 房间查询为空
30001 int 不是当前房间拥有者
40004 int 时间类型不正确
40040 int 请求参数错误
40041 int 创建拉流配置失败
40042 int 创拉流配置冲突
40071 int 参数类型错误
40076 int 参数可选值错误
40079 int 拉流结束时间必须大于当前时间
40080 int 拉流源站URL地址不合法

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
	"config_id":"18930"
    }
}