查询会议投票列表(多问题)
接口描述
描述:
查询指定会议的投票列表。
支持 OAuth 鉴权,权限:查询投票信息或管理投票信息。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls-list
输入参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
operator_id | String | 是 | 操作者 ID。 会议的创建者、主持人、联席主持人,才可以查询投票。 |
operator_id_type | Integer | 是 | 操作者 ID 的类型: 1:企业内用户 userid 2:open_id 4:ms_open_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 |
输出参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
polls_theme_info | PollsTheme 对象数组 | 必须 | 投票主题信息列表。 |
PollsTheme 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
poll_theme_id | String | 必须 | 投票主题 ID。 |
polls_info | PollsInfo 对象数组 | 必须 | 投票信息列表。 |
PollsInfo 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
poll_id | String | 必须 | 投票 ID。 |
poll_topic | String | 必须 | 投票标题。 |
status | Integer | 必须 | 投票状态。 0:未开始 1:投票中 2:已结束 |
is_shared | Integer | 必须 | 共享状态。 0:未共享 1:已共享 |
is_anony | Integer | 必须 | 是否匿名。 0:实名 1:匿名 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 20011 | 无效的 ms_open_id。 |
500 | 20009 | 未查找到相应的会议信息,请检查会议是否存在。 |
500 | 190001 | 存在未注册的用户。 |
500 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
代码示例
输入示例
GET https://api.meeting.qq.com/v1/meetings/100001/polls-list?operator_id=testUser&operator_id_type=1&instanceid=2
输出示例
{"polls_theme_info": [{"poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C","polls_info": [{"poll_id": "B7DD75774-C1B7-C841-B69E-7DF550424191","poll_topic": "API投票测试主题3","status": 1,"is_shared": 0,"is_anony": 0}]}]}
查询会议投票列表(单问题)
接口描述
描述:当用户为会议主持人时,可获取会议下的正在进行中和已结束的投票列表。
注意:
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/votes
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 用户的 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。 |
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_id | 否 | String | 会议 ID。 |
meeting_code | 否 | String | 会议 Code。 |
page | 是 | Integer | 当前页,从1开始。 |
page_size | 是 | Integer | 当前页大小,最小值为1,最大值为20。 |
注意:
meeting_code 和 meeting_id 参数不能同时为空,至少传入一个。
输出参数
参数名称 | 参数类型 | 参数描述 |
vote_total_number | Integer | 投票数量。 |
vote_total_page | Integer | 投票结果总页数。 |
vote_current_page | Integer | 当前页。 |
vote_current_size | Integer | 当前页大小。 |
vote_list | Vote 对象数组 | 投票主题列表。 |
Vote 对象
参数名称 | 参数类型 | 参数描述 |
vote_topic | String | 投票标题,至少1个字符,最多不超过36个字符。 |
vote_theme_id | String | 投票未正式发起前的投票 ID,以“A”开头的一串字符串。 |
vote_id | String | 投票已正式发起后的投票 ID,以“B”开头的一串字符串。 |
status | Integer | 投票状态: 1:正在进行中 2:已结束 |
代码示例
输入示例
GET https://api.meeting.qq.com/v1/votes?userid=tester&instanceid=1&meeting_code=86359399865&page=1&page_size=20
输出示例
{"vote_total_number": 1,"vote_total_page": 1,"vote_current_page": 1,"vote_current_size": 1,"vote_list": [{"vote_topic": "API测试","vote_theme_id": "AB45E1FD8-6EE4-GA65-21HY-AB9DBFE92BFG","vote_id": "BC44E1FD9-6EF4-DA95-29FA-AF9DBEE88FFA","status": 2}]}