企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
会议
Rooms会议室管理
获取Rooms会议室列表
获取Rooms会议室列表
最后更新:2024/07/22

获取企业下的Rooms会议室列表。

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/meeting/rooms/list?access_token=ACCESS_TOKEN

请求包体:

{
	"meeting_room_name": "ROOMNAME",
	"cursor": "CURSOR",
	"limit": 50
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。获取方法查看“获取access_token
meeting_room_namestringRooms会议室名称(支持模糊匹配查找)
cursorstring分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limituint32分页大小,从1开始,最大50,默认20
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。

 

权限说明

  • 仅配置在“可调用接口的应用”列表中的自建应用可调用

 

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"has_more": true,
	"next_cursor": "CURSOR",
	"meeting_room_list":[
		{
			"meeting_room_id":"100001",
			"meeting_room_name":"会议室测试1",
			"meeting_room_location":"广州-大厦-10",
			"account_type":1,
			"active_code":"69MS2PKC",
			"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":"广州-大厦-11",
			"account_type":1,
			"active_code":"69MS2PKC",
			"participant_number":12,
			"meeting_room_status":1,
			"scheduled_status":0,
			"is_allow_call":true
		}
	]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
has_morebool是否还有更多Rooms会议室列表
next_cursorstring分页用,has_more为true时,下一次拉取列表将该字段填入cursor字段
meeting_room_listobject[]Rooms会议室对象列表,详见MeetingRoom

MeetingRoom说明

参数类型说明
meeting_room_idstringRooms会议室 ID
meeting_room_namestringRooms会议室名称
meeting_room_locationstringRooms会议室地址
account_typeuint32账号类型:
0:普通
1:专款
2:试用
active_codestring激活码
participant_numberuint32容纳人数
meeting_room_statusuint32Rooms会议室状态:
0:未激活
1:未绑定
2:空闲
3:使用中
4:离线
scheduled_statusuint32预定状态:
0:未开放预定
1:开放预定
is_allow_callbool是否允许被呼叫:
true:是
false:否
上一篇释放Rooms会议室
下一篇获取Rooms会议室详情
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们