You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

获取直播间红包列表

最近更新时间2023.06.05 13:54:26

首次发布时间2023.02.01 14:10:46

获取直播间的红包列表信息。

请求说明

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

请求参数

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

Query

参数

类型

是否必选

描述

Action

String

接口名称。

Version

String

接口版本。直播当前 API 的版本为 2020-06-01。

ActivityId

Int64

直播间 ID。您可以通过调用 ListActivityAPI 接口查询 ID。

PageNo

Int

分页查询页码,默认取值为 1

PageItemCount

Int

分页查询数量,默认取值为 10

返回参数

参数

类型

描述

RedPacketList

Array of RedPacketData

红包列表信息。

PageNo

Int

分页查询页码。

PageItemCount

Int

分页查询数量。

TotalCount

Int

查询结果总数。

RedPacketData

参数

类型

描述

RedPacketType

Int

红包类型。

  • 0:现金红包
  • 1:积分红包

RewardsPointsUnit

String

积分的单位。

TotalAmount

Int

红包的总金额。

  • RedPacketType 取值为 0 时,该参数值的单位为分。
  • RedPacketType 取值为 1 时,该参数值的单位为 RewardsPointsUnit 的取值。

ReceivedAmount

Int

观众的中奖金额。

  • RedPacketType 取值为 0 时,该参数值的单位为分。
  • RedPacketType 取值为 1 时,该参数值的单位为 RewardsPointsUnit 的取值。

SendTime

Int

红包的发送时间,Unix 时间戳,单位为秒。

JoinUserNumber

Int

参与人数。

WinUserNumber

Int

中奖人数。

WithdrawalAmount

Int

观众的提现金额,单位为分。

说明

仅当 RedPacketType 取值为 0 时,可以进行红包提现。

RedPacketNumber

String

红包的个数。

RedPacketID

Int

红包 ID。

示例

请求示例

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

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "202301120024099CCB1169F45D1CE9F3AD",
        "Action": "ListRedPacketDataAPI",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1673454249
    },
    "Result": {
        "PageNo": 1,
        "PageItemCount": 10,
        "TotalCount": 1,
        "RedPacketList": [
            {
                "SendTime": 1673202413,
                "TotalAmount": 100,
                "ReceivedAmount": 100,
                "JoinUserNumber": 1,
                "WinUserNumber": 1,
                "WithdrawalAmount": 100,
                "RedPacketNumber": 1,
                "RedPacketId": 1754478641139760,
                "RedPacketType": 0,
                "RewardsPointsUnit":""
            }
        ]
    }
}

异常返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023010901154861C57537B04A4A16B7C1",
        "Action": "ListRedPacketDataAPI",
        "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
}

错误码

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

状态码

错误码

错误信息

说明

400

InvalidParameter.ActivityIDInvalid

The specified parameter ActivityID is invalid.

直播间 ID 不符合规范,请修改后重试

500

InternalError

The request has failed due to an unknown error.

请求处理过程中出现了未知错误,请联系技术支持获取帮助