腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 会议管理 > 查询会议报名信息

查询会议报名信息

最近更新时间：2024-04-23 16:12:01

我的收藏

本页目录：

接口描述

描述：查询已报名观众数量和报名观众答题详情，仅会议创建者可查询。
企业 secret 鉴权用户可查询任何该企业用户创建的有效会议，OAuth 2.0 鉴权用户只能查询通过 OAuth 2.0 鉴权创建的有效会议。
调用方用户必须是注册用户，请求头部 X-TC-Registered 字段必须传入为1。
使用获取参会成员列表 接口获得成员的 ms_open_id 后，成员的报名 ID 可以通过 查询会议成员报名 ID 接口，或 查询网络研讨会成员报名 ID 接口来确认和匹配对应的报名信息。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meeting_id}/enroll/approvals

输入参数

参数名称
是否必须
参数描述
operator_id
否
操作者 ID。会议创建者可以导入报名信息。
operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。
operator_id_type=2，operator_id 必须和公共参数的 openid 一致。
operator_id 和 userid 至少填写一个，两个参数如果都传了以 operator_id 为准。
使用 OAuth 公参鉴权后不能使用 userid 为入参。
operator_id_type
否
操作者 ID 的类型：
1：userid
2：open_id
如果 operator_id 和 userid 具有值，则以 operator_id 为准。
userid
否
会议创建者的用户 ID。为了防止现网应用报错，此参数实则仍然兼容 openid，如无 oauth 应用使用报名接口则也可做成不兼容变更。
instanceid
是
用户的终端设备类型：
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
page
是
当前页，页码起始值为1。
page_size
是
分页大小，最大300条。
status
否
审批状态筛选字段，默认返回全部。审批状态：
0：全部。
1：待审批。
2：已拒绝。
3：已批准。

输出参数

参数名称
参数类型
参数描述
current_page
Integer
当前页。
current_size
Integer
当前页实际大小。
enroll_list
Enroll 对象数组
当前页的报名列表，current_size 为0时无该字段。
total_count
Integer
根据条件筛选后的总报名人数。
total_page
Integer
根据条件筛选后的总分页数。

Enroll 对象

参数名称
参数类型
参数描述
answer_list
Answer 对象数组
答题列表。
enroll_id
Integer
报名 ID。
enroll_time
String
报名时间（utc+8，非时间戳）。
enroll_source_type
Integer
报名来源：
1：用户手动报名。
2：批量导入报名。
nick_name
String
昵称。
若通过手机号导入报名且未设置昵称，则该字段显示手机号。
status
Integer
报名状态：
1：待审批。
2：已拒绝。
3：已批准。
userid
String
报名者与会议创建者为同企业时，返回 userid，否则为空。
导入报名入参为手机号的情况不返回 userid。
open_id
String
报名者已授权过会议创建的应用时返回 open_id，否则为空。
ms_open_id
String
当场会议的用户临时 ID，所有用户都有。
enroll_code
String
报名码，用于电话入会的凭证。

Answer 对象

参数名称
参数类型
参数描述
answer_content
String 数组
回答内容：单选和简答只有一个元素，多选会有多个。
is_required
Integer
是否必填：
1：否。
2：是。
question_num
Integer
问题编号，1,2,3...等形式。
question_title
String
问题标题。
question_type
Integer
问题类型：
1：单选
2：多选
3：简答
special_type
String
特殊问题类型：
1：无
2：手机号
3：邮箱
4：姓名
5：组织名称
6：组织规模
说明：目前除组织规模外均为简答题，组织规模为单选题。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
107
查询权限不足。
500
960000
网络错误，请稍后重试。
500
101
会议未开启报名。
500
190001
存在未注册的用户。

示例

输入示例

GET  https://api.meeting.qq.com/v1/meetings/100001/enroll/approvals?userid=user1&instanceid=2&page_size=50&page=1

输出示例

{
    "total_count": "1",
    "total_page": 1,
    "current_page":1,
    "current_size":1,
    "enroll_list":[{
        "enroll_id":1386442,
        "nick_name":"ccc",
        "status":3,
        "enroll_time":"2023-03-23 10:00:00",
        "userid":"",
        "open_id":"",
        "ms_open_id":"agaqwwgdkkddd",
        "enroll_source_type":2,
        "enroll_code":"333333"
    }]
}

中国站