查询用户的会议列表接口描述描述：获取某指定用户的进行中或待开始的会议列表。企业 secret 鉴权用户可查询任何该企业该用户创建的有效会议，OAuth2.0 鉴权用户只能查询通过 OAuth2.0 鉴权创建的有效会议。 调用方式：GET 接口请求域名：https://api.meeting.qq.com/v1/meetings?userid={userid}&instanceid={instanceid} 输入参数以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。参数名称必选参数类型参数描述userid是String调用方用于标示用户的唯一 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。instanceid是Integer用户的终端设备类型：0：PSTN1：PC2：Mac3：Android4：iOS5：Web6：iPad7：Android Pad8：小程序9：voip、sip 设备10：linux20：Rooms for Touch Windows21：Rooms for Touch MacOS22：Rooms for Touch Android30：Controller for Touch Windows32：Controller for Touch Android33：Controller for Touch iOSpos否Integer1.分页获取用户会议列表的查询起始时间值，UNIX 秒级时间戳，只能查询开始时间在本时间之后（包含）的会议（由于存在相同开始时间的会议，所以分页查询后需要根据查询结果的 meeting_id 去重）。2.因目前一次查询返回会议数量最多为20，当用户会议较多时，如果会议总数量超过20，则需要再次查询。此参数为非必选参数，默认值为0，表示从北京时间当日零点开始查询。3.查询返回输出参数“remaining”不为0时，表示还有会议需要继续查询。返回参数“next_pos”的值即为下一次查询的 pos 的值。4.多次调用该查询接口直到输出参数“remaining”值为0。cursory否Integer1.分页获取用户会议列表，查询的会议的最后一次修改时间值，UNIX 毫秒级时间戳，分页游标。2.因目前一次查询返回会议数量最多为20，当用户会议较多时，如果会议总数量超过20，则需要再次查询。此参数为非必选参数，默认值为0，表示第一次查询利用会议开始时间北京时间当日零点进行查询。3.查询返回输出参数“remaining”不为0时，表示还有会议需要继续查询。返回参数“next_cursory”的值即为下一次查询的 cursory 的值。4.多次调用该查询接口直到输出参数“remaining”值为0。5.当只使用 pos 作为分页条件时,可能会出现查询不到第二页,数据排序出现重复数据等情况与 pos 配合使用。is_show_all_sub_meetings否String是否显示周期性会议的所有子会议，默认值为0。0：只显示周期性会议的第一个子会议1：显示所有周期性会议的子会议输出参数参数名称参数类型参数描述meeting_numberinteger会议数量。meeting_info_listArray会议列表。next_posInteger下次查询时请求里需要携带的 pos 参数。remainingInteger是否还剩下会议；因目前一次查询返回会议数量最多为20，如果会议总数量超过20则此字段被置为非0，表示需要再次查询，且下次查询的“pos”参数需从本次响应的“next_pos”字段取值。next_cursoryInteger1.分页获取用户会议列表，查询的会议的最后一次修改时间值，UNIX 毫秒级时间戳，分页游标。2.因目前一次查询返回会议数量最多为20，当用户会议较多时，如果会议总数量超过20，则需要再次查询。此参数为非必选参数，默认值为0，表示第一次查询利用会议开始时间北京时间当日零点进行查询。3.查询返回输出参数“remaining”不为0时，表示还有会议需要继续查询。返回参数“next_cursory”的值即为下一次查询的 cursory 的值。4.多次调用该查询接口直到输出参数“remaining”值为0。5.当只使用 pos 作为分页条件时,可能会出现查询不到第二页,数据排序出现重复数据等情况与 pos 配合使用。 会议对象参数名称参数类型参数描述subject String 会议主题。 meeting_id  String会议的唯一标示 。 meeting_codeString会议 App 的呼入号码。hostsUserObj 数组会议主持人的用户 ID，如果无指定，主持人将被设定为上文的 userid，即 API 调用者。current_hosts用户对象数组会议当前主持人列表。start_timeString会议开始时间戳（单位秒）。end_timeString会议结束时间戳（单位秒）。join_meeting_roleString查询者在会议中的角色：1.creator：创建者2.hoster：主持人3.invitee：被邀请者meeting_typeInteger会议类型：0：普通会议1：周期性会议recurring_ruleperiod_meeting周期性会议设置。media_set_typeInteger该参数仅提供给支持混合云的企业可见，默认值为0。0：外部会议1：内部会议has_more_sub_meetingInteger0：无更多。1：有更多子会议特例。remain_sub_meetingsInteger剩余子会议场数。current_sub_meeting_idString当前子会议 ID（进行中 / 即将开始）。statusString当前会议状态：1.MEETING_STATE_INVALID：非法或未知的会议状态，错误状态。2.MEETING_STATE_INIT：待开始，会议预定到预定结束时间前，会议中无人。3.MEETING_STATE_CANCELLED：已取消，主持人主动取消会议，待开始的会议才能取消，取消的会议无法再进入。4.MEETING_STATE_STARTED：会议中，只要会议中有人即表示进行中。5.MEETING_STATE_ENDED：已删除，结束时间后且会议中无人时，被主持人删除，已删除的会议无法再进入。6.MEETING_STATE_NULL：无状态，过了预定结束时间，会议中无人。7.MEETING_STATE_RECYCLED：已回收，过了预定开始时间30天，会议号被后台回收，无法再进入。typeInteger会议类型：0：预约会议类型1：快速会议类型sub_meetings子会议对象数组周期性子会议列表。子会议对象参数名称参数类型参数描述sub_meeting_idString子会议 ID。statusInteger子会议状态：0：默认(存在)1：已删除start_timeInteger子会议开始时间（UTC 秒）。end_timeInteger子会议结束时间（UTC 秒）。周期性会议 period_meeting参数名称必选参数类型参数描述recurring_type否integer周期性会议频率，默认值为0。0：每天1：每周一至周五2：每周3：每两周4：每月until_type否integer结束重复类型，默认值为0。0：按日期结束重复1：按次数结束重复until_date否integer结束日期时间戳，默认值为当前日期 + 7天。until_count否integer限定会议次数（1-50次）默认值为7次。<span id=“settings”></span> 会议媒体参数对象参数名称参数类型参数描述mute_enable_joinBool加入静音状态。allow_unmute_selfBool静音自解除允许 。示例示例1（单页）输入示例https://api.meeting.qq.com/v1/meetings?userid=tester1&instanceid=1 输出示例{ "meeting_number": 1, "next_pos": 0, "remaining": 0, "meeting_info_list": [ { "subject": "tester's meeting", "meeting_id": "7567173273889276131", "meeting_code": "806146667", "status": "MEETING_STATE_ENDED", "start_time": "1572085800", "end_time": "1572089400", "hosts": [ "tester" ], "join_meeting_role": "invitee"， "meeting_type": 1, //周期性会议会返回以下信息 "recurring_rule": { "recurring_type": 0, "until_type": 1, "until_count": 4 }, "has_more_sub_meetings": 0, "remain_sub_meetings": 3, "current_sub_meeting_id": "1599046220" } ] } 示例2（多页）输入示例（第一次拉取）https://api.meeting.qq.com/v1/meetings?userid=tester1&instanceid=1 输出示例{ "meeting_number": 1, "next_pos": 1572085800, "remaining": 1, "meeting_info_list": [ { "subject": "tester's meeting", "meeting_id": "7567173273889276131", "meeting_code": "806146667", "status": "MEETING_STATE_ENDED", "start_time": "1572085800", "end_time": "1572089400", "hosts": [ "tester" ], "join_meeting_role": "invitee"， "meeting_type": 1, //周期性会议会返回以下信息 "recurring_rule": { "recurring_type": 0, "until_type": 1, "until_count": 4 }, "has_more_sub_meetings": 0, "remain_sub_meetings": 3, "current_sub_meeting_id": "1599046220" } ] } 输入示例（第二次拉取）https://api.meeting.qq.com/v1/meetings?userid=tester1&instanceid=1&pos=1572085800 输出示例{ "meeting_number": 1, "next_pos": 0, "remaining": 0, "meeting_info_list": [ { "subject": "tester's meeting-2", "meeting_id": "7567173273889276131", "meeting_code": "806146667", "status": "MEETING_STATE_ENDED", "start_time": "1572085801", "end_time": "1572089401", "hosts": [ "tester" ], "join_meeting_role": "invitee"， "meeting_type": 1, //周期性会议会返回以下信息 "recurring_rule": { "recurring_type": 0, "until_type": 1, "until_count": 4 }, "has_more_sub_meetings": 0, "remain_sub_meetings": 3, "current_sub_meeting_id": "1599046220" } ] } 下载 腾讯会议API查询用户的会议列表-腾讯会议.pdf