Appearance
消费榜列表
历史版本
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://gateway.nuoyunapi.com/Api/RoomStat/getRoomConsumeRankList/2.0.0 - 频率限制:
10秒1000次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| room_id | 是 | integer | 直播间id |
| page | 是 | integer | 页码,从1开始 |
| page_size | 是 | integer | 每页条数,最大100 |
请求示例
json
{
"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 |
| name | 是 | string | 用户昵称 |
| consumption | 是 | string | 消费金额 |
| photo | 是 | string | 头像 |
| third_openid | 是 | string | 微信openid |
响应示例
json
{
"code": 200,
"data": {
"total": 3,
"list": [
{
"wechat_user_space_id": 10000001,
"name": "用户昵称1",
"consumption": "288.88",
"photo": "https://example.com/avatar1.jpg",
"third_openid": "oABCDEF123456789"
},
{
"wechat_user_space_id": 10000002,
"name": "用户昵称2",
"consumption": "168.50",
"photo": "https://example.com/avatar2.jpg",
"third_openid": "oABCDEF987654321"
},
{
"wechat_user_space_id": 10000003,
"name": "用户昵称3",
"consumption": "99.99",
"photo": "https://example.com/avatar3.jpg",
"third_openid": "oABCDEF555666777"
}
]
},
"msg": "Success"
}状态码说明
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 400 | 失败 |
| -1 | 参数错误 |