查询直播发奖信息

更新时间：2022-12-28

接口描述

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

请求地址

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

请求方式

GET

请求参数

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

名称 类型 必填 描述
userid String 是 开发者账号ID
roomed String 是 直播间ID
liveid String 否 直播ID
page_size Integer 否 第几页，默认1。取值范围:大于1的整数
page_length Integer 否 每页记录条数，默认50。取值范围:1~500整数
type String 否 查询类型，取值说明：cup为奖杯，short_hand为短举手，默认全部，取值范围["cup","short_hand"]

请求示例

GET https://ccapi.csslcloud.net/collect/reward/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说明

名称 类型 描述
reward_time String 发奖时间：格式：yyyy-MM-dd HH:mm:ss
uname String 用户名称，获奖人用户名称
liveid String 直播ID
type String 获奖类型：cup为奖杯，short_hand为短举手
uid String 用户ID，获奖人用户ID
roomid String 直播间ID

返回示例

{
    "page_size": 1,
    "page_count": 1,
    "error_msg": "",
    "result": "OK",
    "page_length": 20,
    "data": [
        {
            "reward_time": "2019-02-19 11:56:03",
            "uname": "ddd",
            "liveid": "EA0A5DF952F42A0C",
            "type": "cup",
            "uid": "bf20806bfecc4955adb6050ecfdb77d0",
            "roomid": "4C05DAC8965BE2029C33DC5901307461"
        }
    ]
}

results matching ""

    No results matching ""