接口描述
描述:查询企业下的会议室列表,目前暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/meeting-rooms?page={page}&page_size={page_size}&meeting_room_name={meeting_room_name}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
page | 否 | Integer | 页码,从1开始,默认1。 |
page_size | 否 | Integer | 分页大小,从1开始,最大50,默认20。 |
meeting_room_name | 否 | String | 会议室名称(支持模糊匹配查找)。 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
total_count | 是 | Integer | 分页查询返回数据总数。 |
current_size | 是 | Integer | 分页查询返回单页数据条数。 |
current_page | 是 | Integer | 分页查询返回当前页码。 |
total_page | 是 | Integer | 分页查询返回分页总数。 |
meeting_room_list | 否 | MeetingRoomList 对象数组 | 会议室对象列表。 |
MeetingRoomList 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_room_id | 是 | String | 会议室 ID。 |
meeting_room_name | 是 | String | 会议室名称。 |
meeting_room_location | 是 | String | 会议室地址。 |
account_new_type | 是 | Integer | 账号新类型: 0:基础账号 1:专业账号 |
account_type | 是 | Integer | 账号类型: 0:普通 1:专款 2:试用 |
active_code | 是 | String | 激活码。 |
participant_number | 是 | Integer | 容纳人数。 |
meeting_room_status | 是 | Integer | 会议室状态: 0:未激活 1:未绑定 2:空闲 3:使用中 4:离线 |
scheduled_status | 是 | Integer | 预定状态: 0:未开放预定 1:开放预定 |
is_allow_call | 是 | Bool | 是否允许被呼叫。 true:是 false:否 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190301 | 请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。 |
400 | 500014 | 账号无权限。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 20201 | 查询会议室信息失败。 |
500 | 190310 | 每分钟总接口调用次数超过限制。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/meeting-rooms?page=1&page_size=2&meeting_room_name=会议室
输出示例
{"total_count":200,"total_page":100,"current_page":1,"current_size":2,"meeting_room_list":[{"meeting_room_id":"100001","meeting_room_name":"会议室测试1","meeting_room_location":"广州-大厦-10","account_type":1,"active_code":"69MS********2PKC","participant_number":12,"meeting_room_status":1,"scheduled_status":0,"is_allow_call":true},{"meeting_room_id":"100002","meeting_room_name":"会议室测试2","meeting_room_location":"西安-广场-19","account_type":0,"active_code":"7G36********9Q3H","participant_number":13,"meeting_room_status":0,"scheduled_status":0,"is_allow_call":true}]}