---
title: "查询房间内榜单"
method: GET
path: "/api/rank/queryRoomRank"
tags: ["榜单管理"]
---

# 查询房间内榜单

`GET /api/rank/queryRoomRank`

## Request

- Base URL: `http://api.oloo.live`
- URL: `http://api.oloo.live/api/rank/queryRoomRank`
- Auth: none declared

查询指定房间内的榜单，支持房间贡献榜、房间魅力榜。

**周期类型说明：**
- 当前周期：day(今日)、week(本周)、month(本月)
- 历史周期：yesterday(昨日)、lastWeek(上周)、lastMonth(上月)

## Query parameters

- `rankType` 'wealth' | 'charm', required
- `roomUid` integer, required
- `uid` integer
- `cycleType` 'day' | 'week' | 'month' | 'yesterday' | 'lastWeek' | 'lastMonth'
- `topN` unknown

## Response `200`

查询成功

- RankResultVO: 榜单查询结果
  - `rankList` SimpleRankVO[]: 榜单列表
    - `uid` integer: 用户ID
    - `nick` string: 用户昵称
    - `avatar` string: 用户头像URL
    - `appNo` string: 用户编号
    - `prettyTypeStr` string: 靓号类型：SS/S/A...
    - `gender` integer: 性别：1-男，2-女
    - `score` number, double: 分数/金币数量
    - `scoreStr` string: 格式化后的分数显示
    - `rank` integer: 排名（从1开始）
    - `regionId` integer: 地区ID
    - `countryIcon` string: 国家/地区图标URL
    - `charmLevel` integer: 魅力等级
    - `charmLevelPic` string: 魅力等级图标URL
    - `wealthLevel` integer: 财富等级
    - `wealthLevelPic` string: 财富等级图标URL
    - `diffScore` number, double: 与上一名的差值
    - `diffScoreStr` string: 格式化后的差值显示
    - `wornMedalList` UserMedalVo[]
      - `medalId` integer: 荣誉ID
      - `medalName` string: 荣誉名称
      - `medalDesc` string: 荣誉描述
      - `picUrl` string: 荣誉图片
      - `vggUrl` string: 荣誉动效
      - `honorPoint` integer: 荣誉积分
      - `sourceType` integer: 来源类型 0-勋章 1-称号 2-证书
    - `vipLevel` integer
    - `vipInfo` UserVipInfoDTO
      - `id` integer
      - `uid` integer
      - `vipLevel` integer
      - `svipLevel` integer
      - `expireTime` string, date-time
      - `useDays` integer
      - `totalDays` integer
      - `vipExtra` VipExtra
        - `nickStyle` integer
        - `idStyle` integer
        - `dynamicAvatar` integer
        - `publicScreen` integer
        - `chatPermission` integer
        - `disableFollowRoom` integer
        - `preventDisableMic` integer
        - `preventRoomBlack` integer
        - `vipGiftBanner` integer
        - `sendProp` integer
        - `hideLevel` integer
        - `hideAccess` integer
        - `hideOnline` integer
        - `rankHide` integer
        - `hideEnterRoom` integer
        - `notifyBannerSwitch` integer
      - `valid` boolean
      - `effectiveLevel` integer
    - `svipLevel` integer
    - `rankHideSwitch` integer
    - `hideLevelSwitch` integer
    - `hasSkipPage` integer
  - `myRank` SimpleRankVO: 排名用户信息
    - `uid` integer: 用户ID
    - `nick` string: 用户昵称
    - `avatar` string: 用户头像URL
    - `appNo` string: 用户编号
    - `prettyTypeStr` string: 靓号类型：SS/S/A...
    - `gender` integer: 性别：1-男，2-女
    - `score` number, double: 分数/金币数量
    - `scoreStr` string: 格式化后的分数显示
    - `rank` integer: 排名（从1开始）
    - `regionId` integer: 地区ID
    - `countryIcon` string: 国家/地区图标URL
    - `charmLevel` integer: 魅力等级
    - `charmLevelPic` string: 魅力等级图标URL
    - `wealthLevel` integer: 财富等级
    - `wealthLevelPic` string: 财富等级图标URL
    - `diffScore` number, double: 与上一名的差值
    - `diffScoreStr` string: 格式化后的差值显示
    - `wornMedalList` UserMedalVo[]
      - `medalId` integer: 荣誉ID
      - `medalName` string: 荣誉名称
      - `medalDesc` string: 荣誉描述
      - `picUrl` string: 荣誉图片
      - `vggUrl` string: 荣誉动效
      - `honorPoint` integer: 荣誉积分
      - `sourceType` integer: 来源类型 0-勋章 1-称号 2-证书
    - `vipLevel` integer
    - `vipInfo` UserVipInfoDTO
      - `id` integer
      - `uid` integer
      - `vipLevel` integer
      - `svipLevel` integer
      - `expireTime` string, date-time
      - `useDays` integer
      - `totalDays` integer
      - `vipExtra` VipExtra
        - `nickStyle` integer
        - `idStyle` integer
        - `dynamicAvatar` integer
        - `publicScreen` integer
        - `chatPermission` integer
        - `disableFollowRoom` integer
        - `preventDisableMic` integer
        - `preventRoomBlack` integer
        - `vipGiftBanner` integer
        - `sendProp` integer
        - `hideLevel` integer
        - `hideAccess` integer
        - `hideOnline` integer
        - `rankHide` integer
        - `hideEnterRoom` integer
        - `notifyBannerSwitch` integer
      - `valid` boolean
      - `effectiveLevel` integer
    - `svipLevel` integer
    - `rankHideSwitch` integer
    - `hideLevelSwitch` integer
    - `hasSkipPage` integer
  - `total` integer: 榜单总人数
  - `sumValue` string: 榜单总数值/格式化后的

## Other responses

- `400`: 参数错误
- `429`: 请求过于频繁

## Changes

- **2026-09-08** `623ae02a1ebf`: 4 info
  - added the optional property `myRank/hideLevelSwitch` to the response with the `200` status
  - added the optional property `myRank/vipInfo` to the response with the `200` status
  - added the optional property `rankList/items/hideLevelSwitch` to the response with the `200` status
  - added the optional property `rankList/items/vipInfo` to the response with the `200` status

[Operation history](https://skmtc.dev/oloo/apis/oloo-api/changes/api/rank/queryRoomRank/get.md)

---

[API](https://skmtc.dev/oloo/apis/oloo-api.md) - [All operations](https://skmtc.dev/oloo/apis/oloo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oloo/apis/oloo-api/revisions/ada91d3a60e4?raw)