Game Progress Mock API

源码: web/src/mock/modules/game/progress.ts

接口列表

方法	路径	说明
POST	/api/v1/games/:gameId/levels/:levelId/result	提交关卡结果

请求参数

POST /api/v1/games/:gameId/levels/:levelId/result

参数	位置	类型	必填	说明
gameId	路径	string	是	游戏ID
levelId	路径	string	是	关卡编号
stars	body	number	否	星级（取最大值保留）
score	body	number	否	分数（取最大值保留）
completed	body	boolean	否	是否通关
completedChars	body	string[]	否	完成的汉字（与已有记录合并去重）

业务逻辑

• 星级和分数取历史最大值保留
• completedChars 与已有记录合并去重
• 通关后自动解锁下一关（levelId + 1）
• 游戏进度不存在时自动初始化

响应格式

POST /api/v1/games/:gameId/levels/:levelId/result

{
  "code": 0,
  "msg": "ok",
  "data": {
    "stars": 3,
    "highScore": 100,
    "completed": true,
    "completedChars": ["一", "二", "三"]
  }
}

被哪个 Store 调用

• GameStore (web/src/stores/game.ts)
  • saveGameResult(gameId, levelId, options) → POST /api/v1/games/:gameId/levels/:levelId/result