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

# 获取房间资料卡

`GET /api/room/profile`

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

**返回信息包括：**
- 房间基本信息（名称、封面、简介等）
- 房主信息（头像、账号等）
- 房间等级信息
- 当前房间成员数量
- 是否已加入房间
- 是否关注房主
- 财富榜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/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)