模块：小游戏模块接口数：16 更新：2026-09-05 16:11

小游戏模块

小游戏控制层 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	否	-

响应说明：

{
  "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	否	-

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

3. minigameUpdate

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

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

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

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

4. minigameDelete

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

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

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

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

5. prizeList

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

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

接口说明：奖品列表

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

6. prizeUpdate

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

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

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

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

7. prizeDelete

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

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

接口说明：删除奖品

请求参数：

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

响应说明：

{
  "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	否	-

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

9. recordDeliver

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

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

接口说明：发货操作

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

10. recordListPhysical

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

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

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

请求参数：

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

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

11. gameList

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

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

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

请求参数：

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

响应说明：

{
  "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	否	-

响应说明：

{
  "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	否	-

响应说明：

{
  "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

响应说明：

{
  "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	否	-

响应说明：

{
  "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	否	-

响应说明：

{
  "code": 1,
  "msg": "",
  "data": ...
}

前端调用参考：

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