---
title: "查询宝箱详情"
method: POST
path: "/room/box/queryRoomBoxItem"
tags: ["房间宝箱"]
---

# 查询宝箱详情

`POST /room/box/queryRoomBoxItem`

## Request

- Base URL: `http://api.oloo.live`
- URL: `http://api.oloo.live/room/box/queryRoomBoxItem`
- Auth: none declared

获取指定等级宝箱的详细信息：

**未开启的宝箱**：
- 奖励预览列表
- 当前贡献榜Top5

**已开启的宝箱**：
- 开奖结果
- 贡献榜排名
- 最后一击用户

**调用时机**：点击宝箱查看详情时

## Query parameters

- `roomUid` unknown, required
- `boxLevel` unknown, required

## Response `200`

查询成功

- RoomBoxItemVO
  - `curBoxMinValue` integer
  - `curBoxMaxValue` integer
  - `curBoxValue` integer
  - `openFlag` boolean
  - `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
  - `lastStrawUser` UserBasicInfo
    - `uid` integer
    - `appNo` string
    - `nickname` string
    - `avatar` string
    - `gender` integer
    - `userDesc` string
    - `regionId` integer
    - `vipLevel` integer
    - `svipLevel` integer
    - `svipEntryUrl` string
    - `svipIdentifierUrl` string
    - `svipTagUrl` string
  - `prizeList` BoxPrizeVO[]
    - `prizeId` integer
    - `type` integer
    - `prizeImgUrl` string
    - `prizeType` string
    - `winnerType` integer
    - `seqNo` integer
    - `prizeNum` integer
    - `value` integer
    - `prizePreviewUrl` string
    - `winnerTypeName` string
    - `boxLevel` integer
  - `boxOpenInfo` RoomBoxPrizeMessage
    - `roomUid` integer
    - `roomId` integer
    - `boxLevel` integer
    - `lastStrawUid` integer
    - `lastStrawUidAvatar` string
    - `lastStrawUidNick` string
    - `topPartitionId` integer
    - `energyUids` integer[]
    - `topEnergyUid` integer
    - `rankAvatarList` string[]
    - `rankUidList` integer[]
    - `messTime` integer
    - `boxDate` string
    - `messId` string
    - `openDuration` integer
    - `isContinuous` boolean
    - `totalLevels` integer
    - `currentLevelIndex` integer
    - `onlineNum` integer
    - `cycleRound` integer
    - `chainId` string

## Other responses

- `400`: 参数错误

## Changes

- **2026-09-08** `623ae02a1ebf`: 2 info
  - 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/room/box/queryRoomBoxItem/post.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)