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

# 查询房间宝箱信息

`POST /room/box/queryRoomBoxInfo`

## Request

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

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

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

## 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/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)