腾讯会议
有奖征文：腾讯云大模型知识引擎xDeepSeek > HOT
文档中心>腾讯会议>开放平台文档>服务端 API>REST API 参考>会前管理>会议管理>查询会议

查询会议

最近更新时间：2025-02-21 16:21:12

我的收藏

本页目录：

通过会议 ID 查询

接口描述

描述：通过会议 ID 查询会议详情。
企业 secret 鉴权用户可查询到任何该用户创建的企业下的会议，OAuth2.0 鉴权用户只能查询到通过 OAuth2.0 鉴权创建的会议。
支持企业管理员查询企业下的会议。
当会议为周期性会议时，主持人密钥每场会议固定，但单场会议只能获取一次。支持查询周期性会议的主持人密钥。
支持查询 MRA 当前所在会议信息。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meetingId}?instanceid={instanceid}&operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_id
是
String
有效的会议 ID。
operator_id
是
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。
operator_id_type
是
Integer
操作者 ID 的类型：
1：userid
2：openid
3：rooms_id
instanceid
是
Integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：linux
20：Rooms for Touch Windows
21：Rooms for Touch MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS

输出参数

参数名称
参数类型
参数描述
meeting_number
Integer
会议数量。
meeting_info_list
MeetingInfo 对象数组
会议列表。

MeetingInfo 对象

参数名称
参数类型
参数描述
subject
String
会议主题。
meeting_id
String
会议的唯一标识。
meeting_code
String
会议 App 的呼入号码。
password
String
会议密码。
need_password
Boolean
非会议创建者是否需要密码入会。
非会议创建者查询会议，且存在会议密码，则字段为 true；其他情况，字段不返回。
status
String
当前会议状态：
MEETING_STATE_INVALID：非法或未知的会议状态，错误状态。
MEETING_STATE_INIT：会议待开始。会议预定到预定结束时间前，会议尚无人进会。
MEETING_STATE_CANCELLED：会议已取消。主持人主动取消会议，待开始的会议才能取消，且取消的会议无法再进入。
MEETING_STATE_STARTED：会议已开始。会议中有人则表示会议进行中。
MEETING_STATE_ENDED：会议已删除。会议已过预定结束时间且尚无人进会时，主持人删除会议，已删除的会议无法再进入。
MEETING_STATE_NULL：会议无状态。会议已过预定结束时间，会议尚无人进会。
MEETING_STATE_RECYCLED：会议已回收。会议已过预定开始时间30天，则会议号将被后台回收，无法再进入。
type
Integer
会议类型：
0：预约会议类型
1：快速会议类型
join_url
String
加入会议 URL。
hosts
User 对象数组
指定主持人列表，仅商业版和企业版可指定主持人。
current_hosts
User 对象数组
会议当前主持人列表。
current_co_hosts
User 对象数组
联席主持人列表。
participants
User 对象数组
邀请的参会者，仅商业版和企业版可邀请参会用户，且只有会议创建者、邀请列表中的成员以及在会议中的成员才可以查询该字段，最多返回200个邀请者；需要查询超过200人的会议邀请者请调用 获取会议受邀成员列表 接口。
start_time
String
会议开始时间戳（单位秒）。
end_time
String
会议结束时间戳（单位秒）。
settings
Setting 对象
会议的配置，可为缺省配置。
meeting_type
Integer
会议类型。
0：一次性会议
1：周期性会议
2：微信专属会议
4：Rooms 投屏会议
5：个人会议号会议
6：网络研讨会
recurring_rule
RecurringRule 对象
周期性会议设置。
sub_meetings
SubMeeting 对象数组
周期性子会议列表（进行中或即将开始）。
has_more_sub_meeting
Integer
0：无更多子会议特例
1：有更多子会议特例
remain_sub_meetings
Integer
剩余子会议场数。
current_sub_meeting_id
String
当前子会议 ID（进行中或即将开始）。
若已开完全部子会议，则返回最后一场子会议 ID。
enable_live
Boolean
是否开启直播（会议创建人才有权限查询）。
true：开启
false：关闭
live_config
LiveConfig 对象
会议的直播配置（会议创建人才有权限查询）。
enable_doc_upload_permission
Boolean
是否允许成员上传文档，默认为允许。
guests
Guest 对象数组
会议嘉宾列表（会议创建人才有权限查询）。
has_vote
Boolean
是否有投票（会议创建人和主持人才有权限查询）。
enable_enroll
Boolean
是否激活报名。
enable_host_key
Boolean
是否开启主持人密钥。
true：开启
false：关闭
host_key
String
主持人密钥，仅支持6位数字（会议创建人才有权限查询）。
如开启主持人密钥后没有填写此项，将自动分配一个6位数字的密钥。
sync_to_wework
Boolean
会议是否同步至企业微信，该字段仅支持创建会议时设置，创建后无法修改。该配置仅支持与企业微信关联的企业。
true：同步，默认同步
false：不同步
time_zone
String
时区，可参见 Oracle-TimeZone 标准。
location
String
会议地点。最长支持18个汉字或36个英文字母。
media_set_type
Integer
0：公网会议
1：专网会议
仅开通混合云功能后支持该参数。
allow_enterprise_intranet_only
Boolean
是否仅允许企业内网络访问入会， 仅专网会议类型返回。 false：不限制用户加入会议使用的网络 true： 仅允许通过企业内网络访问加入会议

User 对象

参数名称
参数类型
参数描述
userid
String
调用方用于标示用户的唯一 ID。
operator_id_type
Integer
用户 ID 类型。
1：userid 2：openid 3：rooms_id 4：ms_open_id
operator_id
String
用户 ID。

Setting 对象

参数名称
参数类型
参数描述
mute_enable_type_join
Integer
成员入会时静音选项。
当同时返回“mute_enable_join”和“mute_enable_type_join”时，请以“mute_enable_type_join”的结果为准。
0：关闭
1：开启
2：超过6人后自动开启
mute_enable_join
Boolean
加入静音状态，默认值为true。
true：开启
false：关闭
allow_unmute_self
Boolean
是否允许参会者取消静音，默认值为true。
true：开启
false：关闭
allow_in_before_host
Boolean
是否允许成员在主持人进会前加入会议，默认值为 true。
true：允许
false：不允许
auto_in_waiting_room
Boolean
是否开启等候室，默认值为 false。
true：开启
false：不开启
allow_screen_shared_watermark
Boolean
是否开启屏幕共享水印，默认值为 false。
true： 开启
false：不开启
water_mark_type
Integer
水印样式，默认为单排：
0：单排
1：多排
only_allow_enterprise_user_join
Boolean
（旧参数）是否仅企业内部成员可入会。
true：仅企业内部用户可入会
false：所有人可入会
only_user_join_type
Integer
成员入会限制。
1：所有成员可入会
2：仅受邀成员可入会
3：仅企业内部成员可入会
当 only_user_join_type 和 only_allow_enterprise_user_join 同时传的时候，以 only_user_join_type 为准。
auto_record_type
String
自动录制类型，仅客户端2.7及以上版本生效。
none：禁用
local：本地录制
cloud：云录制
participant_join_auto_record
Boolean
当有参会成员入会时立即开启云录制，默认值为 false 关闭，关闭时，主持人入会自动开启云录制；当设置为开启时，则有参会成员入会自动开启云录制。
说明：
该参数必须 auto_record_type 设置为“cloud”时才生效，该参数依赖企业账户设置，当企业强制锁定后，该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。
enable_host_pause_auto_record
Boolean
允许主持人暂停或者停止云录制，默认值为 true 开启，开启时，主持人允许暂停和停止云录制；当设置为关闭时，则主持人不允许暂停和关闭云录制。
说明：
该参数必须将 auto_record_type 设置为“cloud”时才生效，该参数依赖企业账户设置，当企业强制锁定后，该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。
allow_multi_device
Boolean
是否允许成员多端入会。

SubMeeting 对象

参数名称
参数类型
参数描述
sub_meeting_id
String
子会议 ID。
status
Integer
子会议状态。
0：默认存在
1：已删除
start_time
String
子会议开始时间（UTC 秒）。
end_time
String
子会议结束时间（UTC 秒）。

RecurringRule 对象

参数名称
必选
参数类型
参数描述
recurring_type
否
Integer
重复类型，默认值为0。
0：每天
1：每周一至周五
2：每周
3：每两周
4：每月
5：自定义，示例请参见 自定义周期规则 API 调用示例
until_type
否
Integer
结束重复类型，默认值为0。
0：按日期结束重复
1：按次数结束重复
until_date
否
Integer
结束日期时间戳，默认值为当前日期 + 7天。
until_count
否
Integer
限定会议次数（1-50次），默认值为7次。
customized_recurring_type
否
Integer
自定义周期性会议的循环类型。
0：按天。
1：按周。
2：按月，以周为粒度重复。例如：每3个月的第二周的周四。
3：按月，以日期为粒度重复。例如：每3个月的16日。
按周；按月、以周为粒度； 按月、以日期为粒度时，需要包含会议开始时间所在的日期。
customized_recurring_step
否
Integer
每[n]（天、周、月）重复，使用自定义周期性会议时传入。
例如：customized_recurring_type=0 && customized_recurring_step=5 表示每5天重复一次。
customized_recurring_type=2 && customized_recurring_step=3 表示每3个月重复一次，重复的时间依赖于 customized_recurring_days 字段。
customized_recurring_days
否
Integer
哪些天重复。
根据 customized_recurring_type 和 customized_recurring_step 的不同，该字段可取值与表达含义不同。如需选择多个日期，加和即可。
customized_recurring_type = 0 时，传入该字段将被忽略。

LiveConfig 对象

参数名称
参数类型
参数描述
live_subject
String
直播主题。
live_summary
String
直播简介。
live_password
String
直播密码。
enable_live_im
Boolean
是否允许观众讨论，默认值为 false。
true：开启
false：不开启
enable_live_replay
Boolean
是否开启直播回看，默认值为 false。
true：开启
false：不开启
live_addr
String
直播观看地址。
live_watermark
LiveWatermark 对象
直播水印对象信息。

LiveWatermark 对象

参数名称
必选
参数类型
参数描述
watermark_opt
否
Integer
水印选项，默认为0。
0：默认水印
1：无水印

Guest 对象

参数名称
参数类型
参数描述
area
String
国家/地区代码（例如：中国传86，不是+86，也不是0086）。
phone_number
String
手机号。
guest_name
String
嘉宾名称。

错误码列表

状态码
错误码
错误描述
400
500014
账号无权限。
400
190301
请求重放错误，请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成，不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
190300
请求头里的时间戳参数 X-TC-Timestamp 取值与服务器当前时间差距超过5分钟，视为非法请求。
400
190004
参数非法，请对照接口文档检查您的参数。
500
41
网络错误，请稍后重试。
500
13000
缓存查询会议信息失败。
500
500001
会议号无效。
500
20000
请检查参数类型。
500
202007
成员不在会中。
500
9042
无权限进行该操作，建议检查操作者身份或资源归属。
500
13704
查询会议列表失败。
500
13703
查询会议失败。
500
13702
查询会议详情失败。
500
9108
用户 sdkID 认证失败。
500
960000
网络错误，请稍后重试。
500
190001
存在未注册的用户。
500
190310
每分钟总接口调用次数超过限制。

代码示例

输入示例

GET https://api.meeting.qq.com/v1/meetings/7567173273889276131?userid=tester1&instanceid=1&operator_id=KM4Ss******gUw1JiK&operator_id_type=1

输出示例（普通会议）

{ 
  "meeting_number": 1, 
  "meeting_info_list": [ 
    { 
      "subject": "tester's meeting", 
      "meeting_id": "7567173273889276131", 
      "meeting_code": "806146667", 
      "password": "1111", 
      "status": "MEETING_STATE_ENDED", 
      "start_time": "1572085800", 
      "end_time": "1572089400", 
      "type": 1, 
      "hosts": [ 
      {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        }
      ],
      "participants": [ 
         {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        } 
      ],
      "join_url": "https://wemeet.qq.com/w/5NmV29k",
      "meeting_type": 0, 
      "settings": { 
        "mute_enable_type_join": 2, 
        "allow_unmute_self": false,
        "play_ivr_on_leave": false,
        "allow_in_before_host": true,
        "auto_in_waiting_room": false,
        "allow_screen_shared_watermark": true,
        "only_allow_enterprise_user_join": false,
        "only_user_join_type":1
      },
       "enable_live":true,
        "live_config":{
            "live_subject":"test",
            "live_summary":"test",
            "live_password":"654321",
            "enable_live_im":true,
            "enable_live_replay":true,
            "live_addr":"https://meeting.tencent.com/l/xxxx",
            "live_watermark":{
              "watermark_opt":0
            }
       },
       "guests":[
          {
                "area":"86",
                "phone_number":"xxxxxxxxx",
                "guest_name":"xxxx"
          }
        ],
        "enable_host_key":true,
        "host_key":"191810"
      } 
    ]
 }

输出示例（周期性会议）

{
  "meeting_number": 1,
  "meeting_info_list": [
    {
      "subject": "tester's meeting",
      "meeting_id": "18357763596888459343",
      "meeting_code": "31380342405",
      "status": "MEETING_STATE_INIT",
      "start_time": "1599622242",
      "end_time": "1599625842",
      "hosts": [
        {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        }
      ],
      "join_url": "https://meeting.tencent.com/s/iY4GQ2HkQQGL",
      "settings": {
        "mute_enable_type_join": 2,
        "allow_unmute_self": false,
        "allow_in_before_host": true,
        "auto_in_waiting_room": true,
        "allow_screen_shared_watermark": true,
        "only_enterprise_user_allowed": false,
        "only_user_join_type":1
      },
      "sub_meetings": [
      {
          "sub_meeting_id": "1599622242",
          "status": 0,
          "start_time": 1599622242,
          "end_time": 1599625842
      },
      {
          "sub_meeting_id": "1599708642",
          "status": 0,
          "start_time": 1599708642,
          "end_time": 1599712242
      },
      {
          "sub_meeting_id": "1599795042",
          "status": 0,
          "start_time": 1599795042,
          "end_time": 1599798642
      },
      {
          "sub_meeting_id": "1599881442",
          "status": 0,
          "start_time": 1599881442,
          "end_time": 1599885042
      },
      {
          "sub_meeting_id": "1599967842",
          "status": 0,
          "start_time": 1599967842,
          "end_time": 1599971442
      }
    ],
    "recurring_rule": {
      "recurring_type": 0,
      "until_type": 1,
      "until_count": 7
    },
    "meeting_type": 1,
    "has_more_sub_meetings": 0,
    "remain_sub_meetings": 5,
    "current_sub_meeting_id": "1599622242",
    "enable_live":true,
    "live_config":{
          "live_subject":"test",
          "live_summary":"test", 
          "live_password":"654321",
          "enable_live_im":true,
          "enable_live_replay":true,
          "live_addr":"https://meeting.tencent.com/l/xxxx"
      },
      "enable_host_key":true,
      "host_key":"191810"
    }
  ]
}

通过会议 Code 查询

接口描述

接口描述：通过会议 Code 查询会议详情。
企业 secret 鉴权用户可查询到任何该用户创建的企业下的会议，OAuth2.0 鉴权用户只能查询到通过 OAuth2.0 鉴权创建的会议。
支持企业管理员查询企业下的会议。
当会议为周期性会议时，主持人密钥每场会议固定，但单场会议只能获取一次。支持查询周期性会议的主持人密钥。
支持查询 MRA 当前所在会议信息。
若会议号被回收则无法通过 Code 查询，您可以通过会议 ID 查询到该会议。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meetings?meeting_code={meetingCode}&userid={userid}&instanceid={instanceid}&operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_code
是
String
有效的9位数字会议号码。
operator_id
是
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。
operator_id_type
是
Integer
操作者 ID 的类型：
1：userid
2：openid
3：rooms_id
userid
否
String
调用方用于标示用户的唯一 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。
企业唯一用户标识说明：
1：企业对接 SSO 时使用的员工唯一标识 ID。
2：企业调用创建用户接口时传递的 userid 参数。
instanceid
是
Integer
用户的终端设备类型：
0：PSTN
1：PC
2：Mac
3：Android
4：iOS
5：Web
6：iPad
7：Android Pad
8：小程序
9：voip、sip 设备
10：Linux
20：Rooms for Touch Windows
21：Rooms for Touch MacOS
22：Rooms for Touch Android
30：Controller for Touch Windows
32：Controller for Touch Android
33：Controller for Touch iOS

输出参数

参数名称
参数类型
参数描述
meeting_number
Integer
会议数量。
meeting_info_list
Meeting 对象数组
会议列表。

Meeting 对象

参数名称
参数类型
参数描述
subject
String
会议主题。
meeting_id
String
会议的唯一标识 。
meeting_code
String
会议 App 的呼入号码。
password
String
会议密码。
need_password
Boolean
非会议创建者是否需要密码入会。
非会议创建者查询会议，且存在会议密码，则字段为 true；其他情况，字段不返回。
status
String
当前会议状态：
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天，则会议号将被后台回收，无法再进入。
type
Integer
会议类型：
0：预约会议类型
1：快速会议类型
join_url
String
加入会议 URL。
hosts
User 对象数组
指定主持人列表，仅商业版和企业版可指定主持人。
participants
User 对象数组
邀请的参会者，仅商业版和企业版可邀请参会用户，且只有会议创建者、邀请列表中的成员以及在会议中的成员才可以查询该字段，最多返回200个邀请者；需要查询超过200人的会议邀请者请调用 获取会议受邀成员列表 接口。
current_hosts
User 对象数组
会议当前主持人列表。
current_co_hosts
User 对象数组
会议联席主持人列表。
start_time
String
会议开始时间戳（单位秒）。
end_time
String
会议结束时间戳（单位秒）。
settings
Setting 对象
会议的配置，可为缺省配置。
meeting_type
Integer
会议类型。
0：一次性会议
1：周期性会议
2：微信专属会议
4：Rooms 投屏会议
5：个人会议号会议
6：网络研讨会
recurring_rule
RecurringRule 对象
周期性会议设置。
sub_meetings
SubMeeting 对象数组
周期性子会议列表（进行中或即将开始）。
has_more_sub_meeting
Integer
0：无更多。
1：有更多子会议特例。
remain_sub_meetings
Integer
剩余子会议场数。
current_sub_meeting_id
String
当前子会议 ID（进行中 / 即将开始）。
若已开完全部子会议，则返回最后一场子会议 ID。
enable_live
Boolean
是否开启直播（会议创建人才有权限查询）。
true：开启
false：关闭
live_config
LiveConfig 对象
会议的直播配置（会议创建人才有权限查询）。
enable_doc_upload_permission
Boolean
是否允许成员上传文档，默认为允许。
guests
Guest 对象数组
会议嘉宾列表（会议创建人才有权限查询）。
has_vote
Boolean
是否有投票（会议创建人和主持人才有权限查询）。
enable_host_key
Boolean
是否开启主持人密钥。
true：开启
false：关闭
host_key
String
主持人密钥，仅支持6位数字（会议创建人才有权限查询）。
如开启主持人密钥后没有填写此项，将自动分配一个6位数字的密钥。
sync_to_wework
Boolean
会议是否同步至企业微信，该字段仅支持创建会议时设置，创建后无法修改。该配置仅支持与企业微信关联的企业。
true：同步，默认同步
false：不同步
time_zone
String
时区，可参见 Oracle-TimeZone 标准。
location
String
会议地点。最长支持18个汉字或36个英文字母。
media_set_type
Integer
0：公网会议
1：专网会议
仅开通混合云功能后支持该参数
allow_enterprise_intranet_only
Boolean
是否仅允许企业内网络访问入会， 仅专网会议类型返回。 false：不限制用户加入会议使用的网络 true： 仅允许通过企业内网络访问加入会议

User 对象

参数名称
参数类型
参数描述
userid
String
用户 ID。
operator_id_type
Integer
用户 ID 类型。
1：userid 2：openid 3：rooms_id 4：ms_open_id
operator_id
String
用户 ID。

Setting 对象

参数名称
参数类型
参数描述
mute_enable_type_join
Integer
成员入会时静音选项。
当同时返回 mute_enable_join 和 mute_enable_type_join 时，请以 mute_enable_type_join 的结果为准。
0：关闭
1：开启
2：超过6人后自动开启
mute_enable_join
Boolean
加入静音状态，默认值为true。
true：开启
false：关闭
allow_unmute_self
Boolean
是否允许参会者取消静音，默认值为true。
true：开启
false：关闭
allow_in_before_host
Boolean
是否允许成员在主持人进会前加入会议，默认值为 true。
true：允许
false：不允许
auto_in_waiting_room
Boolean
是否开启等候室，默认值为 false。
true：开启
false：不开启
allow_screen_shared_watermark
Boolean
是否开启屏幕共享水印，默认值为 false。
true： 开启
false：不开启
water_mark_type
Integer
水印样式，默认为单排：
0：单排
1：多排
only_allow_enterprise_user_join
Boolean
是否仅企业内部成员可入会。
true：仅企业内部用户可入会。
false：所有人可入会。
auto_record_type
String
自动录制类型，仅客户端2.7及以上版本生效。
none：禁用
local：本地录制
cloud：云录制
participant_join_auto_record
Boolean
当有参会成员入会时立即开启云录制，默认值为 false 关闭，关闭时，主持人入会自动开启云录制；当设置为开启时，则有参会成员入会自动开启云录制。
说明：
该参数必须将 auto_record_type 设置为“cloud”时才生效，该参数依赖企业账户设置，当企业强制锁定后，该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。
enable_host_pause_auto_record
Boolean
允许主持人暂停或者停止云录制，默认值为 true 开启，开启时，主持人允许暂停和停止云录制；当设置为关闭时，则主持人不允许暂停和关闭云录制。
说明：
该参数必须将 auto_record_type 设置为“cloud”时才生效，该参数依赖企业账户设置，当企业强制锁定后，该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。

SubMeeting 对象

参数名称
参数类型
参数描述
sub_meeting_id
String
子会议 ID。
status
Integer
子会议状态。
0：默认（存在）
1：已删除
start_time
String
子会议开始时间（UTC 秒）。
end_time
String
子会议结束时间（UTC 秒）。

RecurringRule 对象

参数名称
必选
参数类型
参数描述
recurring_type
否
Integer
重复类型，默认值为0。
0：每天
1：每周一至周五
2：每周
3：每两周
4：每月
5：自定义，示例请参见 自定义周期规则 API 调用示例
until_type
否
Integer
结束重复类型，默认值为0。
0：按日期结束重复
1：按次数结束重复
until_date
否
Integer
结束日期时间戳，默认值为当前日期 + 7天。
until_count
否
Integer
限定会议次数（1-50次）默认值为7次。
customized_recurring_type
否
Integer
自定义周期性会议的循环类型。
0：按天。
1：按周。
2：按月，以周为粒度重复。例如：每3个月的第二周的周四。
3：按月，以日期为粒度重复。例如：每3个月的16日。
按周；按月、以周为粒度； 按月、以日期为粒度时，需要包含会议开始时间所在的日期。
customized_recurring_step
否
Integer
每[n]（天、周、月）重复，使用自定义周期性会议时传入。
例如：customized_recurring_type=0 && customized_recurring_step=5 表示每5天重复一次。
customized_recurring_type=2 && customized_recurring_step=3 表示每3个月重复一次，重复的时间依赖于 customized_recurring_days 字段。
customized_recurring_days
否
Integer
哪些天重复。根据 customized_recurring_type 和 customized_recurring_step 的不同，该字段可取值与表达含义不同。如需选择多个日期，加和即可。
customized_recurring_type = 0 时，传入该字段将被忽略。

LiveConfig 对象

参数名称
参数类型
参数描述
live_subject
String
直播主题。
live_summary
String
直播简介。
live_password
String
直播密码。
enable_live_im
Boolean
是否允许观众讨论，默认值为 false。
true：开启
false：不开启
enable_live_replay
Boolean
是否开启直播回看，默认值为 false。
true：开启
false：不开启
live_addr
String
直播观看地址。
live_watermark
object
直播水印对象信息。

LiveWatermark 对象

参数名称
必选
参数类型
参数描述
watermark_opt
否
Integer
水印选项，默认为0。
0：默认水印
1：无水印

Guest 对象

参数名称
参数类型
参数描述
area
String
国家/地区代码（例如：中国传86，不是+86，也不是0086）。
phone_number
String
手机号。
guest_name
String
嘉宾名称。

代码示例

输入示例

GET https://api.meeting.qq.com/v1/meetings?meeting_code=806146667&userid=tester1&instanceid=1&operator_id=KM4Ss******gUw1JiK&operator_id_type=1

输出示例（普通会议）

{ 
  "meeting_number": 1, 
  "meeting_info_list": [ 
    { 
      "subject": "tester's meeting", 
      "meeting_id": "7567173273889276131", 
      "meeting_code": "806146667", 
      "password": "1111", 
      "status": "MEETING_STATE_ENDED", 
      "start_time": "1572085800", 
      "end_time": "1572089400", 
      "hosts": [ 
          {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        } 
      ], 
      "participants": [ 
          {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        } 
      ], 
      "join_url": "https://wemeet.qq.com/w/5NmV29k",
      "meeting_type":0, 
      "settings": { 
        "mute_enable_type_join": 2, 
        "allow_unmute_self": false,
        "play_ivr_on_leave": false,
        "allow_in_before_host": true,
        "auto_in_waiting_room": false,
        "allow_screen_shared_watermark": true,
        "only_allow_enterprise_user_join": false,
        "only_user_join_type":1
      },
      "enable_live":true,
      "live_config":{
            "live_subject":"test",
            "live_summary":"test", 
            "live_password":"654321",
            "enable_live_im":true,
            "enable_live_replay":true,
            "live_addr":"https://meeting.tencent.com/l/xxxx",
            "live_watermark":{
                "watermark_opt":0
           }
      },
      "guests":[
          {
              "area":"86",
              "phone_number":"xxxxxxxxx",
              "guest_name":"xxxx"
          }
      ],
      "enable_host_key":true,
      "host_key":"191810"
    } 
  ]
}

输出示例（周期性会议）

{
  "next_pos": 0,
  "remaining": 0,
  "meeting_number": 1,
  "meeting_info_list": [
    {
      "subject": "tester's meeting",
      "meeting_id": "7567173273889276131",
      "meeting_code": "806146667",
      "status": "MEETING_STATE_INIT",
      "start_time": "1599622242",
      "end_time": "1599625842",
      "hosts": [
        {
          "userid": "tester",
          "operator_id_type":1,
          "operator_id":"tester"
        }
      ],
      "join_url": "https://meeting.tencent.com/s/iY4GQ2HkQQGL",
      "settings": {
        "mute_enable_type_join": 2,
        "allow_unmute_self": false,
        "allow_in_before_host": true,
        "auto_in_waiting_room": true,
        "allow_screen_shared_watermark": true,
        "only_enterprise_user_allowed": false,
        "only_user_join_type":1
      },
      "sub_meetings": [
        {
          "sub_meeting_id": "1599622242",
          "status": 0,
          "start_time": 1599622242,
          "end_time": 1599625842
        },
        {
          "sub_meeting_id": "1599708642",
          "status": 0,
          "start_time": 1599708642,
          "end_time": 1599712242
        },
        {
          "sub_meeting_id": "1599795042",
          "status": 0,
          "start_time": 1599795042,
          "end_time": 1599798642
        },
        {
          "sub_meeting_id": "1599881442",
          "status": 0,
          "start_time": 1599881442,
          "end_time": 1599885042
        },
        {
          "sub_meeting_id": "1599967842",
          "status": 0,
          "start_time": 1599967842,
          "end_time": 1599971442
        }
      ],
      "recurring_rule": {
        "recurring_type": 0,
        "until_type": 1,
        "until_count": 7,
      },
      "meeting_type": 1,
      "has_more_sub_meetings": 0,
      "remain_sub_meetings": 5,
      "current_sub_meeting_id": "1599622242",
      "enable_live":true,
      "live_config":{
            "live_subject":"test",
            "live_summary":"test", 
            "live_password":"654321",
            "enable_live_im":true,
            "enable_live_replay":true,
            "live_addr":"https://meeting.tencent.com/l/xxxx"
      },
      "enable_host_key":true,
      "host_key":"191810"
      }
    ]
 }


中国站
文档活动
message-icon联系我们
目录