更新时间:2023-12-29 GMT+08:00

激活会议

描述

该接口用于通过会议ID和会议密码激活会议。所有的会控接口都需要在会议激活后才能调用,可以通过该接口先激活会议。

来宾密码是否可以激活会议取决于会议创建时是否设置了“是否允许来宾启动会议”(allowGuestStartConf=true)。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

POST

请求地址

/v1/mmc/management/conferences/start

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

X-Access-Token

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

conferenceID

String

Body

会议ID。

password

String

Body

会议密码。

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常。

响应参数

表4 响应参数

参数

类型

描述

uuid

String

uuid。

说明:

废弃参数,请勿使用。

regionIP

String

会议所在区域的公网IP地址。

请求消息示例

POST /v1/mmc/management/conferences/start HTTP/1.1
Connection: keep-alive
X-Access-Token: *******
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "conferenceID": "986030665",
    "password": "******"
}

响应消息示例

HTTP/1.1 200 OK
Content-Length: 141
Cache-Control: no-store
Connection: keep-alive
Content-Type: application/json
Date: Thu, 24 Dec 2020 06:25:59 GMT
Server: api-gateway
X-APIG-Latency: 261
X-APIG-Ratelimit-Api: remain:99,limit:100,time:1 minute
X-APIG-Ratelimit-Api-Allenv: remain:199,limit:200,time:1 second
X-APIG-Upstream-Latency: 259
X-Envoy-Upstream-Service-Time: 210
X-Request-Id: f991eeec77df1692c74f253d765ca146

{
	"uuid": "stb7fe307f8971e44acc5cf8be2112575ff8387ff6ddea68a5e",
	"regionIP": "100.94.23.40"
}

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心

CURL命令示例

curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d '{"conferenceID": "986030665","password": "******"}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences/start'