查询投票列表信息

更新时间: 2022-12-28

接口描述

查询投票列表信息，可以查询单场直播的投票记录信息，也可以查询某个直播间下的所有投票记录信息
说明：直播中使用了投票工具，结束直播后可以查看投票的历史信息

请求地址

https://ccapi.csslcloud.net/collect/vote/record

请求方式

GET

请求参数

接口统一权限认证请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 开发者账号
roomid String 是 直播间ID
liveid String 否 直播ID，如果该参数传值，查询是该场直播的投票数据
page_size Integer 否 第几页，默认1。取值范围:大于1的整数
page_length Integer 否 每页记录条数，默认50。取值范围:1~500整数

请求示例

GET https://ccapi.csslcloud.net/collect/vote/record?userid=41E8063FC799ACE&roomid=D90DCF5BF6DA3C8C9C33DC5901307461&liveid=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}

返回数据

公共返回数据结构请参考 公共返回数据说明。

名称 类型 描述
result String 返回状态，"OK"：成功，"FAIL"：失败
page_length Integer 每页记录条数
page_count Integer 总记录条数
page_size Integer 页码，当前第几页
data Array 投票信息列表

data说明

名称 类型 描述
reply_data Array 投票回复记录列表
publish_data Object 发布投票信息

reply_data说明

名称 类型 描述
uid String 用户（学员）ID，投票回复用户的唯一标识
uname String 用户名称，投回复票的用户名
choices Array 投票选项，用户（学员）投票的选项

publish_data说明

名称 类型 描述
style Integer 投票类型：0为单选，1为多选
choices Array 选项
vote_id String 投票唯一标识
publish_time String 发布投票的时间；格式：yyyy-MM-dd HH:mm:ss
roomid String 直播间ID
title String 投票主题
uid String 发布者ID，发布投票的用户ID
liveid String 直播ID
uname String 发布者名称，发布投票的用户名称

返回示例

{
    "page_length": 20,
    "page_count": 1,
    "data": [

        {
            "reply_data": [
                {
                    "uid": "d44fda4f15a14b92a733b237d957611f",
                    "choices": [
                        1
                    ],
                    "uname": "ddd"
                }
            ],
            "publish_data": {
                "style": 0,
                "choices": [
                    "fdg",
                    "fsdf",
                    "wef"
                ],
                "publish_time": "2019-01-30 15:53:40",
                "roomid": "4C05DAC8965BE2029C33DC5901307461",
                "vote_id": "9d84f73d05bd4d930d97b01840796c5c",
                "title": "we",
                "uid": "24140669d42843a8b0c58e8338ab8382",
                "liveid": "96AC5FB6817E01DC",
                "uname": "aaa"
            }
        }
    ],
    "result": "OK",
    "page_size": 1,
    "error_msg": ""
}

results matching ""

    No results matching ""