---
title: "查询房间宝箱信息"
method: POST
path: "/room/box/queryRoomBoxInfo"
tags: ["房间宝箱"]
---

# 查询房间宝箱信息

`POST /room/box/queryRoomBoxInfo`

获取房间当前宝箱的完整信息，包括：
- 当前经验值和进度
- 当前等级和最大等级
- 各等级宝箱配置（图片、颜色等）
- 宝箱状态（是否已达最高等级）

**调用时机**：进入房间时、宝箱进度变化时

## Query parameters

- `roomUid` unknown, required
- `appVersion` unknown, required

## Response `200`

查询成功

- RoomBoxVO
  - `curBoxLevel` integer — 当前宝箱等级
  - `curBoxMaxValue` integer — 当前等级宝箱开启经验值
  - `curBoxValue` integer — 当前宝箱经验值
  - `boxStatus` integer
  - `boxList` RoomBoxDTO[] — 宝箱对象
    - `boxLevel` integer — 宝箱等级
    - `boxValue` integer — 宝箱值
    - `boxMinValue` integer — 宝箱最低值
    - `boxTotalValue` integer — 宝箱值
    - `unOpenUrl` string — 宝箱未开启图片
    - `openUrl` string — 宝箱开启图片
    - `progressColor` string — 进度条色号
    - `openFlag` boolean — 是否开启
    - `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
  - `boxPrizeList` BoxPrizeVO[] — 当前等级宝箱奖励
    - `prizeId` integer
    - `type` integer
    - `prizeImgUrl` string
    - `prizeType` string
    - `winnerType` integer
    - `seqNo` integer
    - `prizeNum` integer
    - `value` integer
    - `prizePreviewUrl` string
    - `winnerTypeName` string
    - `boxLevel` integer

## Other responses

- `400` — 参数错误

---

[API](https://skmtc.dev/oloo/apis/openapi-definition.md) · [All operations](https://skmtc.dev/oloo/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oloo/openapi-definition/revisions/c0963217c1b7/schema)