# 小游戏模块

小游戏控制层 MinigameController @author system

**类路径**：`MinigameController`
**前缀**：`/typechoMinigame`

## 1. minigameList

**接口路径**：`GET/POST /typechoMinigame/minigameList`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：小游戏列表（管理后台）

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| searchParams | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| page | Integer | 否 | 1 |  |
| searchKey | String | 否 | - |  |
| order | String | 否 | created |  |
| limit | Integer | 否 | 15 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.gameList()  （https://api.ruletree.club/typechoMinigame/gameList）

---

## 2. minigameAdd

**接口路径**：`GET/POST /typechoMinigame/minigameAdd`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：新增小游戏活动

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| params | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 3. minigameUpdate

**接口路径**：`GET/POST /typechoMinigame/minigameUpdate`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：更新小游戏活动

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| params | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 4. minigameDelete

**接口路径**：`GET/POST /typechoMinigame/minigameDelete`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：删除小游戏活动

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| id | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 5. prizeList

**接口路径**：`GET/POST /typechoMinigame/prizeList`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：奖品列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 6. prizeUpdate

**接口路径**：`GET/POST /typechoMinigame/prizeUpdate`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：新增/更新奖品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| params | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 7. prizeDelete

**接口路径**：`GET/POST /typechoMinigame/prizeDelete`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：删除奖品

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| id | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 8. recordList

**接口路径**：`GET/POST /typechoMinigame/recordList`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：抽奖记录列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| searchParams | String（JSON 字符串，需后端解析） | 否 | - | JSON 字符串，需后端解析 |
| page | Integer | 否 | 1 |  |
| limit | Integer | 否 | 15 |  |
| searchKey | String | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 9. recordDeliver

**接口路径**：`GET/POST /typechoMinigame/recordDeliver`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：发货操作

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| id | Integer | 否 | - |  |
| delivered | Integer | 否 | 1 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 10. recordListPhysical

**接口路径**：`GET/POST /typechoMinigame/recordListPhysical`

**权限**：公开接口；但当系统配置 isLogin=1 时会强制要求登录

**接口说明**：实物奖品列表（待发货）

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| limit | Integer | 否 | 100 |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

---

## 11. gameList

**接口路径**：`GET/POST /typechoMinigame/gameList`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：用户可参与的活动列表

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| token | String | 否 | - |  |
| uid | Integer | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.gameList()  （https://api.ruletree.club/typechoMinigame/gameList）

---

## 12. gameDetail

**接口路径**：`GET/POST /typechoMinigame/gameDetail`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：活动详情

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| token | String | 否 | - |  |
| uid | Integer | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.gameDetail()  （https://api.ruletree.club/typechoMinigame/gameDetail）

---

## 13. gamePlay

**接口路径**：`GET/POST /typechoMinigame/gamePlay`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：执行抽奖

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| token | String | 否 | - |  |
| uid | Integer | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.gamePlay()  （https://api.ruletree.club/typechoMinigame/gamePlay）

---

## 14. myPrizes

**接口路径**：`GET/POST /typechoMinigame/myPrizes`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：我的中奖记录

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| uid | Integer | 否 | - |  |
| token | String | 否 | - |  |
| limit | Integer | 否 | 20 |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.myPrizes()  （https://api.ruletree.club/typechoMinigame/myPrizes）

---

## 15. recentWinners

**接口路径**：`GET/POST /typechoMinigame/recentWinners`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：最近中奖记录

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| minigameId | Integer | 否 | - |  |
| limit | Integer | 否 | 10 |  |
| token | String | 否 | - |  |
| uid | Integer | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.recentWinners()  （https://api.ruletree.club/typechoMinigame/recentWinners）

---

## 16. bindAddress

**接口路径**：`GET/POST /typechoMinigame/bindAddress`

**权限**：未标注（按代码逻辑，通常需登录或走其它校验）

**接口说明**：绑定收货地址

**请求参数**：

| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|--------|------|------|--------|------|
| recordId | Integer | 否 | - |  |
| addressId | Integer | 否 | - |  |
| addressSnapshot | String | 否 | - |  |
| uid | Integer | 否 | - |  |
| token | String | 否 | - |  |

**响应说明**：
```json
{
  "code": 1,
  "msg": "",
  "data": ...
}
```

**前端调用参考**：
- 前端调用：this.$API.bindAddress()  （https://api.ruletree.club/typechoMinigame/bindAddress）

---