接口：礼物/打赏列表

  • 礼物/打赏列表

请求URL:

GET/v2/reward/list

参数:

参数名 是否必须 说明
type 否 gift:礼物 reward:打赏
activity_id 否 用户维度下传0.活动维度下传活动ID

返回参数说明:

公共相应参数，详细内容请参考[返回结果]

返回数据如下：

参数名 类型 说明
code string 状态码
msg string 状态信息
data object 数据
data[list] array 数据数组
data[list][id] string 礼物／打赏ID
data[list][online_status] string 上下架状态(0:下架,1:上架)
data[list][price] string 金额
data[list][status] string 0:系统默认打赏 1:普通打赏
data[list][activity_id] string 用户维度下返回0，活动维度下返回活动ID
data[list][full_screen_status] string 全屏特效开关(0:关闭 1:开启)
data[list][image_url] string 礼物图片
data[list][full_screen_image_url] string 礼物全屏效果图片
data[list][name] string 礼物名称
data[list][created_at] string 创建时间
data[list][updated_at] string 最后更新时间
data[total] string 总数

请求结果示例:

正确时返回:


{
    "code": 200,
    "msg": null,
    "data": {
        "list": [
            {
                "id": 1333,
                "name": "",
                "online_status": 1,
                "price": "0.88",
                "full_screen_status": 0,
                "image_url": "",
                "full_screen_image_url": "",
                "status": 0,
                "activity_id": "0",
                "created_at": "2021-05-13 09:40:47",
                "updated_at": "2021-05-13 09:40:47"
            },
        ],
        "total": 1
    }
}

失败时返回:

{
    "code": 201,
    "msg": "activity_id 不能为空。",
    "data": null
}

备注:

  • 更多返回错误代码请看首页的错误代码描述