---
title: "获取礼物列表"
method: GET
path: "/api/room/giftList"
tags: ["聊天室"]
---

# 获取礼物列表

`GET /api/room/giftList`

获取房间可用的礼物列表。

**礼物类型：**
- 1: 普通礼物
- 2: 幸运礼物

**返回字段：**
- giftId: 礼物ID
- giftName: 礼物名称
- giftIcon: 礼物图标
- giftPrice: 礼物价格（金币）
- giftType: 礼物类型
- animationType: 动画类型（0-无，1-SVGA，2-Lottie）
- animationUrl: 动画资源URL

## Query parameters

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

## Response `200`

获取成功

- GiftVO[]
  - `baseId` string
  - `giftId` integer — 礼物ID
  - `giftName` string — 礼物名称
  - `giftType` integer — 礼物类型:0普通,1豪华,2连击,3座驾,4特效...
  - `price` integer — 虚拟币
  - `imgUrl` string — 礼物图片
  - `animUrl` string — 礼物动画资源URL
  - `animFormat` string — 动画格式:svga, mp4, lottie, gif...
  - `comboFlag` boolean — 是否支持连击:0否,1是
  - `giftIconUrls` string
  - `vipLevel` integer
  - `isRoomGift` integer — 是否房间礼物: 0-否, 1-是
  - `roomMemberLevel` integer — 最低房间成员等级
  - `giftSubType` string — 礼物类型细分：空/vip=VIP礼物，svip=SVIP礼物
  - `roomMemberLevelPic` string — 成员等级图标
  - `bannerPic` string — 礼物banner图片地址
  - `bannerSkipUri` string — 礼物banner跳转地址

---

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