礼物榜列表

历史版本

• 礼物榜列表

请求路径

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://gateway.nuoyunapi.com/Api/RoomStat/getRoomGiftRankList/2.0.0
• 频率限制：10秒1000次

请求参数

参数	必选	类型	描述
room_id	是	integer	直播间id
page	是	integer	页码，从1开始
page_size	是	integer	每页条数，最大100

请求示例

{
    "room_id": 10001,
    "page": 1,
    "page_size": 10
}

响应参数

参数	必选	类型	描述
code	是	number	状态码：200-成功，400-失败
msg	是	string	提示信息
data	是	object	消息内容

data 参数结构

参数	必选	类型	描述
list	是	array	榜单列表
total	是	integer	总条数

list 参数结构

参数	必选	类型	描述
wechat_user_space_id	是	integer	用户id
from_client_name	是	string	用户昵称
gift_money_sum	是	string	礼物金额
client_photo	是	string	头像
third_openid	是	string	微信openid

响应示例

{
  "code": 200,
  "data": {
    "total": 2,
    "list": [
      {
        "wechat_user_space_id": 10000001,
        "from_client_name": "昵称1",
        "gift_money_sum": "0.06",
        "client_photo": "https://example.com/avatar1.jpg",
        "third_openid": "oABCDEF123456789"
      },
      {
        "wechat_user_space_id": 10000002,
        "from_client_name": "昵称2",
        "gift_money_sum": "0.01",
        "client_photo": "https://example.com/avatar2.jpg",
        "third_openid": "oABCDEF987654321"
      }
    ]
  },
  "msg": "Success"
}

状态码说明

状态码	描述
200	成功
400	失败
-1	参数错误