快速接入

确认您已完成开放平台权限及账号的申请,并创建应用，如未完成请先完成开通账号/权限

您可使用 API 向微吼DEP活动平台的服务端地址发送请求，并按照接口说明在请求中加入相应请求参数。系统会根据请求的处理情况，返回处理结果。本文介绍了企业直播 API 的调用方法，包括请求结构、签名机制和公共错误码。

API 的服务接入地址，如下表所示。

区域	服务地址
中国大陆	https://saas-open.vhall.com

微吼DEP活动平台目前仅支持通过 HTTPS 协议进行通信，请务必通过 HTTPS 方式调用所有 API 接口，以保障数据传输的安全性与可靠性。

请求及返回结果使用 UTF-8 字符集进行编码。

根据各个接口的具体需求，选择 GET 或 POST 方式发起请求。

方法	说明
GET	用于获取资源信息，请求参数应通过 URL 查询字符串（query string）传递。
POST	用于创建资源或触发特定操作，请求参数应通过请求体（body）传递。

请求 URI 的组成结构 : {域名} + {业务接口地址}
业务接口地址 : /v3/webinars/webinar/create
拼接后接口 URL：https://saas-open.vhall.com/v3/webinars/webinar/create

为明确请求来源 , 且为了更好串联请求和排除定位问题, API 请求发起方可以自定义请求id , 参数名request-id , 表示每次请求唯一的请求标识,针对每次请求不可重复,调用方可随机生成;

参数名	类型	必选	说明
app_key	string	是	应用 key
signed_at	string	是	签名时间戳，必传参数，取当前 UNIX 时间戳，单位为秒。注意：如果与服务器时间相差超过 5 分钟，会提示签名过期报错。
sign_type	integer	否	签名方式：0=md5(默认)、1=RSA、2=SHA256、3=SM3
sign	string	是	签名数据值，生成方式见签名示例

详细的签名机制和签名示例，请参见签名方法。

错误码请参照全局错误码