查询会议详情

curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' https://

api.meeting.huaweicloud.com/v1/mmc/management/conferences

请求地址 /v1/mmc/management/conferences/confDetail 传输协议 HTTPS

请求参数

表4-51 参数说明

参数 是否必须 类型 位置 描述

conferenc

eID 是 String Query 会议ID。

offset 否 Integer Query 指定返回的与会者列表 的页面索引，默认为 0。针对PageParticipant 中的 与会者分页。

limit 否 Integer Query 指定返回的与会者记录 数。默认值20。针对 PageParticipant 中的 与会者分页。

searchKey 否 String Query 用来作关键词查询的字 符串。长度限制为 1-128个字符。

userUUID 否 String Query 用户的UUID。第三方 鉴权时需要携带。

X-Access-Token 是 String Header 授权令牌。获取“执行 App ID鉴权”响应的 accessToken。

X-Type 否 Integer Header 默认值为0。

● 0：不区分终端和与 会人。

● 1：分页查询区分终 端和与会人，结果 合并返回。

● 2：单独查询终端和 与会人，结果单独 返回。

X-Query-Type 否 Integer Header 当“X-Type”“2”

时，有效。默认为0。

● 0：查询与会人。

● 1：查询终端。

参数 是否必须 类型 位置 描述 X-Authorizat

ion-Type

否 String Header 标识是否为第三方

portal过来的请求。

X-Site-Id 否 String Header 用于区分到哪个HCSO 站点鉴权。

状态码

表4-52 状态码说明

HTTP状态码 描述

200 操作成功。

400 参数异常。

401 未鉴权或鉴权失败。

403 权限受限。

500 服务端异常。

响应参数

表4-53 响应参数

参数 类型 描述

conferenceData ConferenceInfo object 会议信息。

data PageParticipant object 与会者列表。

表4-54 PageParticipant 数据结构

参数 类型 描述

limit Integer 每页的记录数。

count Integer 总记录数。

offset Integer 记录数偏移，这一页之前

共有多少条。

参数 类型 描述 data Array of ParticipantInfo

objects 被邀请的与会者信息。包

含预约会议时邀请的与会 者和会中主持人邀请的与 会者。

说明

● 不返回会中主动加入的 与会者信息。

表4-55 ParticipantInfo 数据结构

参数 类型 描述

participantID String 与会者的号码。

name String 与会者的名称（昵称）。

subscriberID String 与会者的号码（预留字

段）。

role Integer 会议中的角色。

● 1：会议主持人。

● 0：普通与会者。

state String 用户状态。目前固定返回

MEETTING。

address String 终端所在会议室信息。

（预留字段）

attendeeType String 默认值由会议AS定义。

● “normal”：软终 端。

● “telepresence”：智 真。单屏、三屏智真均 属此类。（预留字段）

● “terminal”：会议室 或硬终端。

● “outside”：外部与 会人。

● “mobile”：用户手机 号码。

● “telephone”：用户 固定电话。（预留字 段）

参数 类型 描述

accountId String 与会者的账号ID。

● 如果是账号/密码鉴权 场景，表示华为云会议 帐号ID。

● 如果是APP ID鉴权场 景，表示第三方的User ID。

phone2 String 当“attendeeType”为

“telepresence”时，且 设备为三屏智真，则该字 段填写左屏号码。（预留 字段）

phone3 String 当“attendeeType”为

“telepresence”时，且 设备为三屏智真，则该字 段填写右屏号码。（预留 字段）

email String 邮件地址。最大不超过

255个字符。

sms String 短信通知的手机号码。最

大不超过127个字符。

deptName String 部门名称。最大不超过96

个字符。

userUUID String 预订者的用户UUID。

appId String App ID，应用标识，一个

应用只需创建一次，参考

“App ID的申请”

isAutoInvite Integer 会议开始时是否自动邀请 该与会者。默认值由企业 级配置决定。0： 不自动 邀请

● 1： 自动邀请 isNotOverlayPidName Boolean 是否不叠加会场名

● true：不叠加

● false：叠加

请求消息示例

GET /v1/mmc/management/conferences/confDetail?conferenceID=914083136 Connection: keep-alive

X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC user-agent: WeLink-desktop

Host: api.meeting.huaweicloud.com

User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

响应消息示例

HTTP/1.1 200

Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 "mediaTypes": "Voice,Data,Video", "subject": "user01的会议", "size": 1,

"timeZoneID": "56",

"startTime": "2019-12-18 07:28", "endTime": "2019-12-18 09:28", "conferenceState": "Created", "accessNumber": "+991117",

"userUUID": "ff808081699b56cb0169be103500012b", "scheduserName": "user8002",

"chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/

914083136/6a30b8b5a325105da031442627828e496f91021ece36405f", "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/

914083136/9505dc3349228b1ce0db8165590cc977bcff89785130fe0d",

"deptName": "wangyue",

"confUUID": "050c7898216811eaa6958bf3bb9ac167"

}, "data": { "offset": 0, "limit": 20, "count": 1, "data": [ {

"participantID": "+991116003815", "name": "user01",

"role": 0,

"state": "MEETTING", "attendeeType": "normal", "accountId": "user01"

} ] } }

错误码

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

请参考华为云API错误中心。

CURL 命令示例

curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://

api.meeting.huaweicloud.com/v1/mmc/management/conferences/confDetail?conferenceID=914083136'