激活会议
描述
该接口用于通过会议ID和会议密码激活会议。所有的会控接口都需要在会议激活后才能调用,可以通过该接口先激活会议。
来宾密码是否可以激活会议取决于会议创建时是否设置了“是否允许来宾启动会议”(allowGuestStartConf=true)。
调试
您可以在API Explorer中调试该接口。
接口原型
请求方法 |
POST |
---|---|
请求地址 |
/v1/mmc/management/conferences/start |
传输协议 |
HTTPS |
请求参数
参数 |
是否必须 |
类型 |
位置 |
描述 |
---|---|---|---|---|
X-Access-Token |
是 |
String |
Header |
授权令牌。获取“执行App ID鉴权”响应的accessToken。 |
conferenceID |
是 |
String |
Body |
会议ID。 |
password |
是 |
String |
Body |
会议密码。 |
状态码
HTTP状态码 |
描述 |
---|---|
200 |
操作成功。 |
400 |
参数异常。 |
401 |
未鉴权或鉴权失败。 |
403 |
权限受限。 |
500 |
服务端异常。 |
响应参数
参数 |
类型 |
描述 |
---|---|---|
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'