---
title: "获取房间资料卡"
method: GET
path: "/api/room/profile"
tags: ["聊天室"]
---

# 获取房间资料卡

`GET /api/room/profile`

## Request

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

获取房间资料卡详细信息。

**返回信息包括：**
- 房间基本信息（名称、封面、简介等）
- 房主信息（头像、账号等）
- 房间等级信息
- 当前房间成员数量
- 是否已加入房间
- 是否关注房主
- 财富榜top3
- 魅力榜top3

**使用场景：**
- 用户查看房间详情时展示资料卡

## Query parameters

- `roomUid` integer, required
- `uid` integer, required

## Response `200`

获取成功

- RoomProfileVO: 房间资料卡VO
  - `roomUid` integer: 房主UID
  - `appNo` string: 房主账号
  - `roomId` integer: 房间ID
  - `roomName` string: 房间标题
  - `type` integer: 房间类型
  - `avatar` string: 房主头像
  - `coverUrl` string: 房间封面URL
  - `roomDesc` string: 房间简介
  - `memberCount` integer: 房间成员数量
  - `normalManagerCount` integer: 普通管理员数量
  - `superManagerCount` integer: 超级管理员数量
  - `top30MemberList` UserBasicInfo[]: 前30成员头像列表
    - `uid` integer
    - `appNo` string
    - `nickname` string
    - `avatar` string
    - `gender` integer
    - `userDesc` string
    - `regionId` integer
    - `vipLevel` integer
    - `svipLevel` integer
    - `svipEntryUrl` string
    - `svipIdentifierUrl` string
    - `svipTagUrl` string
  - `roomLevelInfo` RoomLevelInfoVO: 房间等级信息VO
    - `level` integer: 房间等级
    - `exp` integer: 当前经验值
    - `levelName` string: 等级名称
    - `levelPic` string: 等级图标
    - `nextExp` integer: 下一等级所需经验值
    - `memberMaxCount` integer: 房间成员最大数量
    - `superManagerNum` integer: 高级管理员限制数量
    - `normalManagerNum` integer: 普通管理员限制数量
    - `privilege` RoomLevelPrivilegeInfoVO
      - `hasBroadcastLevelUp` boolean: 是否升级发全服
  - `memberLevelInfo` RoomMemberLevelInfoVO: 房间成员等级信息VO
    - `level` integer: 成员等级
    - `levelName` string: 等级名称
    - `levelPic` string: 等级图标
    - `exp` integer: 当前经验值
    - `nextExp` integer: 下一等级所需经验值
    - `privilege` RoomMemberLevelPrivilegeInfoVO
      - `hasBroadcastLevelUp` boolean: 是否升级发全服
  - `isJoined` boolean: 是否加入房间成员
  - `focus` boolean: 是否关注房间
  - `wealthRankTop3` RoomProfileRankVO[]: 财富榜top3
    - `uid` integer: 用户UID
    - `appNo` string: 账号
    - `avatar` string: 用户头像
    - `nick` string: 用户昵称
    - `gender` integer: 用户性别
    - `rank` integer: 榜单排名
    - `total` number, double: 榜单分数
    - `vipLevel` integer: 当前VIP等级
    - `svipLevel` integer: 当前SVIP等级
  - `charmRankTop3` RoomProfileRankVO[]: 魅力榜top3
    - `uid` integer: 用户UID
    - `appNo` string: 账号
    - `avatar` string: 用户头像
    - `nick` string: 用户昵称
    - `gender` integer: 用户性别
    - `rank` integer: 榜单排名
    - `total` number, double: 榜单分数
    - `vipLevel` integer: 当前VIP等级
    - `svipLevel` integer: 当前SVIP等级

## Other responses

- `404`: 房间不存在

---

[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)