获取直播间投票数据

获取直播间的投票数据。

请求说明

• 接口名称：GetVoteStatisticsAPI
• 请求方式：GET
• 接口地址：http://livesaas.volcengineapi.com/?Action=GetVoteStatisticsAPI&Version=2020-06-01
• 请求频率：单用户请求频率限制为 120 次/分钟。
  

请求参数

以下请求参数列表仅列出了该接口的部分公共参数，完整公共参数列表见公共请求参数。

Query

返回参数

VoteStatistics

VoteUserChose

示例

请求示例

Get http://livesaas.volcengineapi.com/?Action=GetVoteStatisticsAPI&Version=2020-06-01&ActivityId=1231231231&VoteId=vote17544725050763

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230111220338BE4E6B41689F6C1A64C1",
        "Action": "GetVoteStatisticsAPI",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1673445818
    },
    "Result": {
        "VoteStatisticsList": [
            {
                "UserChose": [
                    {
                        "OptionSite": "D",
                        "OptionName": "投票内容"
                    }
                ],
                "UserName": "aa1",
                "IP": "10.5.22.56",
                "VoteTime": 1673169500,
                "Extra": "abc",
                "UserID": 1738686737584142,
                "UserTel": "137xxxxx88",
                "Email": "zhibo@xxx.com",
                "UserAgent": "Intel Mac OS X 10_15_7",
                "ExternalId": "1605756488530014"
            }
        ],
        "PageNo": 1,
        "PageCount": 10,
        "TotalCount": 1
    }
}

异常返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023010901154861C57537B04A4A16B7C1",
        "Action": "GetVoteStatisticsAPI",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "Error": {
            "Code": "InvalidParameter.ActivityIdNotFound",
            "Message": "The specified parameter ActivityId is invalid."
        },
        "SystemTime": 1673198148
    },
    "Result": null
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码文档。