查询会议投票详情(多问题)
接口描述
接口描述:
查投票的详情,包括问题、选项、投票结果。
支持 OAuth 鉴权,权限:查询投票信息或管理投票信息。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/polls/{poll_id}
输入参数
参数名称 | 是否必须 | 是否必须 | 参数描述 |
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 |
poll_id | String | 是 | 投票 ID。 |
输出参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
meeting_id | String | 必须 | 会议 ID。 |
poll_theme_id | String | 必须 | 投票主题 ID。 |
poll_id | String | 必须 | 投票 ID。 |
poll_topic | String | 必须 | 投票主题。 |
poll_desc | String | 必须 | 投票描述。 |
is_anony | Integer | 必须 | 是否匿名。 0:实名 1:匿名 |
status | Integer | 必须 | 投票状态。 0:未开始 1:投票中 2:已结束 |
is_shared | Integer | 必须 | 是否共享。 |
vote_total_num | Number | 必须 | 投票人数。 |
poll_question_data | PollQuestion 对象数组 | 必须 | 投票结果数组。 |
PollQuestion 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
question_desc | String | 必须 | 问题描述。 |
question_type | Integer | 必须 | 问题类型。 0:单选 1:多选 |
question_id | String | 必须 | 问题 ID。 |
option_info | OptionInfo 对象数组 | 必须 | 选项信息数组。 |
OptionInfo 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
option_id | Number | 必须 | 选项 ID。 |
option_desc | String | 必须 | 选项描述。 |
option_num | Integer | 必须 | 每个选项的投票数。 |
rate | Integer | 必须 | 投票比率。 |
option_user | OptionUser 对象数组 | 必须 | 用户信息数组。 |
OptionUser 对象
参数名称 | 参数类型 | 是否必须 | 参数描述 |
nick_name | String | 必须 | 用户昵称,如果非匿名,展示。 |
userid | String | 必须 | 用户 userid,同企业才展示 userid。如果非匿名,展示。 |
open_id | String | 必须 | 用户 open_id,如果非匿名,展示。 |
ms_open_id | String | 必须 | 用户 ms_open_id,如果非匿名,展示。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 310001 | 会议与投票不匹配。 |
500 | 190001 | 存在未注册的用户。 |
500 | 300102 | 投票已被删除。 |
500 | 20011 | 无效的 ms_open_id。 |
500 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
500 | 20009 | 未查找到相应的会议信息,请检查会议是否存在。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
代码示例
输入示例
GET https://api.meeting.qq.com/v1/meetings/100001/polls/B7DD75774-C1B7-C841-B69E-7DF550424191?operator_id=testUser1&operator_id_type=1&instanceid=2
输出示例
{"meeting_id": "100001","poll_theme_id": "A19124181-C250-5D5C-6AEB-2BE21CA3DD6C","poll_id": "B7DD75774-C1B7-C841-B69E-7DF550424191","poll_topic": "API投票测试主题3","poll_desc": "API投票测试主题描述3","is_anony": 0,"status": 1,"is_shared": 0,"vote_total_num": 0,"poll_question_data": [{"question_id": "Q26405070-A1F3-F165-F34A-9F89057FC99A","question_desc": "问题4","question_type": 0,"option_info": [{"option_id": 1297247,"option_desc": "选项1","option_num": 0,"rate": 0},{"option_id": 1297248,"option_desc": "选项2","option_num": 0,"rate": 0},{"option_id": 1297249,"option_desc": "选项3","option_num": 0,"rate": 0}]},{"question_id": "Q08709EC1-FB87-85B6-045A-104F9D62BBCB","question_desc": "问题5","question_type": 0,"option_info": [{"option_id": 1297250,"option_desc": "1","option_num": 0,"rate": 0},{"option_id": 1297251,"option_desc": "2","option_num": 0,"rate": 0},{"option_id": 1297252,"option_desc": "3","option_num": 0,"rate": 0}]}]}
查询会议投票详情(单问题)
接口描述
接口描述:当用户为会议主持人时,可获取会议下的正在进行中或已结束的一个投票的投票结果。
注意:
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/votes/{voteId}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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。 |
注意:
meeting_code 和 meeting_id 参数不能同时为空,至少传入一个。
输出参数
参数名称 | 参数类型 | 参数描述 |
vote_topic | String | 投票主题。 |
vote_desc | String | 投票描述。 |
vote_theme_id | String | 投票未正式发起前的投票 ID,以“A”开头的一串字符串。 |
vote_id | String | 投票已正式发起后的投票 ID,以“B”开头的一串字符串。 |
vote_type | Integer | 投票选择类型: 0:单选 1:多选 |
is_anony | Integer | 是否匿名: 0:实名 1:匿名 |
meeting_id | String | 会议 ID |
userid | String | 用户的 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。 |
status | Integer | 投票状态: 1:正在进行中 2:已结束 |
vote_total_num | Integer | 投票总票数。 |
vote_opt_list | VoteOpt 对象数组 | 投票选项详情列表。 |
VoteOpt 对象
参数名称 | 参数类型 | 参数描述 |
opt_id | String | 投票 ID。 |
opt_desc | String | 投票描述。 |
opt_number | Integer | 选择此项的数量。 |
opt_user_list | OptUser 对象数组 | 选择此项的用户列表,最多支持100个用户。 |
OptUser 对象
参数名称 | 参数类型 | 参数描述 |
userid | String | 投票用户的 ID(返回同企业内的 userid,企业外的用户返回为空)。 |
nick_name | String | 用户昵称。 |
代码示例
输入示例
GET https://api.meeting.qq.com/v1/votes/BA2F117B3-F7D6-7276-4E7D-E3680B03685D?userid=tester&instanceid=10&meeting_code=86359399865
输出示例
{"vote_topic": "API测试修改投票主题","vote_desc": "测试","vote_theme_id": "AB45E1FD8-6EE4-GA65-21HY-AB9DBFE92BFG","vote_id": "BA2F117B3-F7D6-7276-4E7D-E3680B03685D","vote_type": 0,"is_anony": 0,"meeting_id": "4086006821859918718","userid": "haynesxiang","status": 2,"vote_total_num": 1,"vote_opt_list": [{"opt_id": "20435","opt_desc": "99","opt_number": 0}, {"opt_id": "20436","opt_desc": "999","opt_number": 0}, {"opt_id": "20437","opt_desc": "9999","opt_number": 1,"opt_user_list": [{"userid": "john117","nick_name": "xxxx"}]}]}