通过会议 ID 查询会议嘉宾列表
接口描述
描述:通过会议 ID 查询会议嘉宾列表,只有会议创建人才有权限查询。
注意:
只有商业版、企业版或教育版用户可以使用会议嘉宾功能,免费版尚无此功能。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/guests/{meeting_id}?userid={userid}&instanceid={instanceid}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议 ID。 |
userid | 是 | String | 用户的 ID(企业内部请使用企业唯一用户标识,OAuth2.0 鉴权用户请使用 openId)。 |
instanceid | 是 | Integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:Linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
输出参数
参数名称 | 参数类型 | 参数描述 |
meeting_id | String | 会议 ID。 |
meeting_code | String | 会议 Code。 |
subject | String | 会议主题。 |
guests | Guest 对象数组 | 会议嘉宾列表数组。 |
Guest 对象
参数名称 | 参数类型 | 参数描述 |
area | String | 国家/地区代码(例如:中国传86,不是+86,也不是0086)。 |
phone_number | String | 手机号。 |
guest_name | String | 嘉宾名称。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 9042 | 无权限操作。 |
500 | 13703 | 查询会议失败。 |
500 | 9003 | 会议信息不存在。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 190001 | 用户未创建,请参考创建用户接口创建用户。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/guests/15923312864334416762?userid=leonxsun&instanceid=1
输出示例
{"meeting_id":"15923312864334416762","meeting_code":"653202434","subject":"jiabin","guests":[{"area":"86","phone_number":"xxxxxx","guest_name":"test"}]}
通过会议 Code 查询会议嘉宾列表
接口描述
描述:通过会议 Code 查询会议嘉宾列表,只有会议创建人才有权限查询。
注意:
只有商业版、企业版或教育版用户可以使用会议嘉宾功能,免费版尚无此功能。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/guests?meeting_code={meeting_code}&userid={userid}&instanceid={instanceid}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_code | 是 | String | 会议 Code。 |
userid | 是 | String | 用户的 ID(企业内部请使用企业唯一用户标识,OAuth2.0 鉴权用户请使用 openId)。 |
instanceid | 是 | Integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:Linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
输出参数
参数名称 | 参数类型 | 参数描述 |
meeting_id | String | 会议 ID。 |
meeting_code | String | 会议 Code。 |
subject | String | 会议主题。 |
guests | Guest 对象数组 | 会议嘉宾列表数组。 |
Guest 对象
参数名称 | 参数类型 | 参数描述 |
area | String | 国家/地区代码(例如:中国传86,不是+86,也不是0086)。 |
phone_number | String | 手机号。 |
guest_name | String | 嘉宾名称。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 9042 | 无权限操作。 |
500 | 190001 | 用户未创建,请参考创建用户接口创建用户。 |
500 | 13703 | 查询会议失败。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 9003 | 会议信息不存在。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/guests?meeting_code=653202434&userid=xxx&instanceid=1
输出示例
{"meeting_id":"15923312864334416762","meeting_code":"653202434","subject":"jiabin","guests":[{"area":"86","phone_number":"xxxxxx","guest_name":"test"}]}