开始直播 - 开放平台

注意事项

正式直播中不能开始彩排，彩排中也不能开始正式直播;

如果使用三方推流，如OBS，则start_type必须传4, 否则会造成直播出现黑屏;

curl --location --request POST 'https://saas-open.vhall.com/v3/webinars/live/start' \ --header 'platform: 15' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'webinar_id=509154312' \ --data-urlencode 'start_type=4' \ --data-urlencode 'live_type=0' \ --data-urlencode 'app_key=' \ --data-urlencode 'sign_type=' \ --data-urlencode 'signed_at=' \ --data-urlencode 'sign='

{ "code": 200, "msg": "", "data": { "switch_id": 4240761, "start_time": "2025-07-08 16:12:38", "end_time": "0000-00-00 00:00:00", "start_type": 4, "end_type": 0, "type": 0 }, "request_id": "11710a81-b733-4864-aa61-2abc44c8a7b8" }

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

platform

integer

可选

默认值:

Body 参数application/x-www-form-urlencoded

webinar_id

string

活动id

必需

示例值:

509154312

start_type

string

必需

推流方式 :

4 : OBS（三方推流工具）

7 : openApi

示例值:

live_type

string

可选

0 : 直播

2 : 彩排

示例值:

app_key

string

必需

平台分配的APP KEY

默认值:

sign_type

integer

必需

签名类型 : 0=MD5,1=RSA,2=SHA256,3=SM3

默认值:

signed_at

integer

必需

签名时间戳 , 当前 UNIX 时间戳，单位为秒。注意：与服务器时间差不得超过5秒

默认值:

sign

string

计算生成的签名值

必需

默认值:

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回结果的状态码（200 成功)

msg

string

必需

当返回结果的状态码不为200时，包含的错误信息

data

object

必需

switch_id

integer

本场场次id

必需

start_time

string

本场开始时间

必需

end_time

string

本场结束时间

必需

start_type

integer

本场开始场景类型

必需

end_type

integer

本场结束场景类型

必需

type

integer

必需

场次类型 :
0 : 直播
1 : 录制
2 : 彩排

request_id

string

必需