---
title: "用户进阶礼物进度"
method: GET
path: "/api/gift/upgrade/progress"
tags: ["礼物模块"]
---

# 用户进阶礼物进度

`GET /api/gift/upgrade/progress`

## Request

- Base URL: `http://api.oloo.live`
- URL: `http://api.oloo.live/api/gift/upgrade/progress`
- Auth: none declared

点击进阶礼物进度条打开半屏页时调用

## Query parameters

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

## Response `200`

OK

- WebServiceMessageGiftUpgradeProgressVO
  - `code` integer
  - `data` GiftUpgradeProgressVO
    - `uid` integer: 用户uid
    - `giftId` integer: 礼物ID
    - `giftName` string: 礼物名称
    - `experience` integer: 当前等级内经验值
    - `giftLevelInfo` GiftUpgradeLevelExtendDTO
      - `level` integer: 进阶等级
      - `picUrl` string: 进阶等级图片
      - `needMin` integer: 进阶等级最小经验值
      - `needMax` integer: 进阶等级最大经验值
      - `decayRatio` number: 衰减比率
      - `hasSvga` boolean: 是否有SVGA动效
      - `svgaUrl` string: SVGA动效URL
      - `hasMp4` boolean: 是否有MP4特效
      - `mp4Url` string: MP4特效URL
      - `hasLevelUpRoomBanner` boolean: 升级是否有房间横幅
      - `hasLevelUpFullServerBanner` boolean: 升级是否有全服横幅
    - `nextGiftLevelInfo` GiftUpgradeLevelExtendDTO
      - `level` integer: 进阶等级
      - `picUrl` string: 进阶等级图片
      - `needMin` integer: 进阶等级最小经验值
      - `needMax` integer: 进阶等级最大经验值
      - `decayRatio` number: 衰减比率
      - `hasSvga` boolean: 是否有SVGA动效
      - `svgaUrl` string: SVGA动效URL
      - `hasMp4` boolean: 是否有MP4特效
      - `mp4Url` string: MP4特效URL
      - `hasLevelUpRoomBanner` boolean: 升级是否有房间横幅
      - `hasLevelUpFullServerBanner` boolean: 升级是否有全服横幅
    - `highestLevel` boolean: 是否已达最高等级
  - `message` string
  - `time` integer

## Changes

- **2026-09-08** `623ae02a1ebf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/oloo/apis/oloo-api/changes/api/gift/upgrade/progress/get.md)

---

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