企业内部开发 服务端API 会议 会议统计管理 获取会议发起记录
获取会议发起记录
最后更新:2024/04/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取会议发起记录
最后更新:2024/04/01

该接口用于获取员工发起的会议记录及其状态,包含员工主动发起快速会议及作为首位参与者进入预约会议的场景。

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

请求包体:

{
   "type": 1,
   "begin_time": 1700000000,
   "end_time": 1700001000,
   "limit": 1000,
   "cursor": "CURSOR"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。获取方法查看“获取access_token
typeint查询类型。
1:发起成功的会议记录
2:发起失败的会议(企业同时发起的会议数已达上限,员工无法发起)
begin_timeint查询范围起始时间戳,单位为秒
end_timeint查询范围结束时间戳,单位为秒
limitint每次拉取的数据量,默认值200,最大值1000
cursorstring用于分页查询的游标,由上一次调用返回,首次调用可不填

补充说明:

查询时间跨度不能超过30天,查询区间是左闭右开的
记录会按时间从大到小排序
会过滤会议发起者不在应用可见范围中的记录,因此返回的记录数可能会小于limit设置的最大记录数。

权限说明:

  • 会议发起者需要在应用可见范围内
  • 自建应用需要配置在“可调用接口的应用”列表

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"next_cursor": "abcd",
	"meeting_list": [
		{
			"userid": "USERID1",
			"start_time": 1700000000
		},
		{
			"userid": "USERID2",
			"start_time": 1700000000
		}
	]
}

参数说明:

参数类型说明
errcodeint返回码
errmsgstring对返回码的文本描述内容
next_cursorstring当前数据最后一个key值,如果下次调用带上该值则从该key值往后拉,用于实现分页拉取
has_morebool是否还有数据待拉取
meeting_listobject[]发起会议成功或失败的记录信息,取决于请求中的type参数
meeting_list.useridstring会议发起者的userid。如果是企业外部成员作为首位参与者进入预约会议,则该字段为此预约会议创建者的userid
meeting_list.start_timeint会议发起时间
上一篇
获取成员会议ID列表
下一篇
创建预约会议