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

获取指定Rooms会议室下的会议列表。

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

请求包体:

{
	"meeting_room_id": "MEETINGROOMID",
	"rooms_id": "ROOMSID",
	"start_time": 1679299200,
	"end_time": 1679558400,
	"cursor": "CURSOR",
	"limit": 20
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。获取方法查看“获取access_token
meeting_room_idstringRooms会议室 ID,与rooms_id二者填其一。
rooms_idstringrooms 设备 rooms_id。与meeting_room_id二者填其一。
start_timeuint32Unix 时间戳。查询起始时间,时间区间不超过90天
end_timeuint32Unix 时间戳。查询结束时间,时间区间不超过90天
cursorstring分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limituint32分页大小,默认20条,最大20条
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。

 

权限说明

  • 仅配置在“可调用接口的应用”列表中的自建应用可调用
  • 仅允许获取该应用创建的会议的数据

 

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"has_more": true,
	"next_cursor": "CURSOR",
	"meeting_info_list":[
		{
			"meetingid": "100001",
			"meeting_code": "14512",
			"subject": "周会",
			"status": "MEETING_STATE_STARTED",
			"meeting_type": 0,
			"start_time": 1679313600,
			"end_time": 1679317200
		}
	]
}

参数说明:

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

MeetingInfo说明

参数类型说明
meetingidstring会议 ID
meeting_codestring有效会议 Code
subjectstring会议主题
statusstring会议状态:
MEETING_STATE_INVALID:非法或未知状态
MEETING_STATE_INIT:待开始
MEETING_STATE_CANCELLED:已取消
MEETING_STATE_STARTED:进行中
MEETING_STATE_ENDED:已删除
MEETING_STATE_NULL:无状态(过了预定结束时间,会中无人)
MEETING_STATE_RECYCLED:已回收(过了预定开始时间30天,会议号被后台回收,无法再进入)
meeting_typeuint32会议类型:
0:一次性会议。
1:周期性会议。
2:微信专属会议。
4:rooms 投屏会议。
5:个人会议号会议。
6:网络研讨会(Webinar)。
start_timeuint32会议预订开始时间(Unix 秒)
end_timeuint32会议预订结束时间(Unix 秒)
上一篇获取Rooms会议室配置项
下一篇获取设备列表
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们