查询会议报名信息

最近更新时间:2024-07-08 11:48:51

我的收藏

接口描述

描述:查询已报名观众数量和报名观众答题详情,仅会议创建者可查询。
企业 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"
}]
}