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