最新消息:

微社区投票接口文档-查询投票

JavaScript相关 admin 204浏览 0评论

简单描述

查询投票情况,包括:投票信息,各投票项目前的投票人数,用户自己是否有投票等。

请求示例

http://app.ingame.qq.com/php/ingame/interactcenter/query_vote2_info.php?game=[$game]&bid=[$bid]&optids=[$optids]&nologin=[0或1]&[登录态相关参数]&headurl_num=[$headurl_num]

请求方式

GET

内网测试环境

!!#ff0000 注:正式上线时需要去掉sandbox=1,并且使用正式域名app.ingame.qq.com!!

1、添加额外参数

&sandbox=1&openid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 注意:openid需要添加白名单(联系jackyxiao(肖改))

2、域名

使用测试域名:appt.ingame.qq.com 或 配置host: 10.222.143.153 app.ingame.qq.com

参数说明

登录参数

见《微社区登录》文档

业务参数

参数 类型 描述 必须 备注
nologin int 是否为非登录状态 PC端用户可能未登录,此时传1可获取投票信息,但无法知道用户是否已投票
game string 游戏id
bid string 业务id
voteid int 投票id 目前为数字类型id,如有特殊需求,可以使用字符型id
optids string 投票选项列表 逗号分隔的数字列表,如: 1,2,3
headurl_num int 查询最近投票人头像 0-为不查询,>0时为查询头像数,最多10个

返回结果

请求成功示例

{
    "status":"SUCCESS",
    "msg":"操作成功",
    "data":{
        "vote_info":{
            "descr":"投票描述",
            "max_num":1,
            "periodtype":1,
            "state":0,
            "user_vote":1,
            "voteid":"4"
            "headurls":[  "http://hello.qq.com/test/1.png" ]    #前端需要进行全角转半角
            "options":[
                {
                    "num":3,
                    "optid":1,
                    "user_vote":0
                },
                {
                    "num":2,
                    "optid":4,
                    "user_vote":1
                },
            ],
        }
    }
}

请求失败示例

{
    "status":"ERROR",
    "msg":"操作失败",
    "data":{
        "code": 3, //错误码
        "msg": "invalid game", //错误信息
    }
}

参数说明

业务参数

参数 类型 描述 备注
status string 返回状态,SUCCESS-成功,其他失败
msg string 返回失败时的提示消息
voteid int 投票id,用于区分不同的投票
descr string 投票描述
max_num int 投票个数 用户最多可投多少个选项,为1时为单项选择
periodtype int 周期类型,0-非周期,1-每日一投
state int 投票状态,0-正在投票中,1-未开始,2-已结束
user_vote int 用户是否已投票,0-未投票,1-已投票
headurls 列表 最近投票的用户头像 前端需要进行全角转半角
options 列表 选项列表
optid int 选项id 如果查询的选项id没有出现在返回列表中,表明此选项无人选
num int 投票数,如果是周期投票,为所有周期内的投票总数之和
options.user_vote int 用户是否有投此选项,0-未投票,1-已投票

转载请注明:文档库 » 微社区投票接口文档-查询投票

发表我的评论
取消评论
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址