Achievement Badges Mock API

源码: web/src/mock/modules/achievement/badges.ts

接口列表

方法	路径	说明
GET	/api/v1/achievements/badges	获取所有徽章定义

请求参数

无请求参数。

响应格式

GET /api/v1/achievements/badges

返回 BADGE_DEFS 中定义的所有徽章：

{
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "id": "first_write",
      "name": "初次书写",
      "desc": "完成第一次书写练习",
      "category": "write",
      "icon": "first_write"
    },
    {
      "id": "learn_10",
      "name": "十字探索者",
      "desc": "学会10个汉字",
      "category": "explore",
      "icon": "learn_10"
    }
  ]
}

每个徽章定义包含：

字段	类型	说明
id	string	徽章唯一标识
name	string	徽章名称
desc	string	徽章描述
category	string	徽章分类（write / explore / streak / game / etymology）
icon	string	徽章图标名

注意：此接口返回的是徽章定义，不包含用户的解锁状态。解锁状态由 GET /api/v1/users/me/badges 提供。

被哪个 Store 调用

• AchievementStore (web/src/stores/achievement.ts)
  • load() → GET /api/v1/achievements/badges
  • allBadges / unlockedBadges 计算属性依赖此数据 + 用户徽章记录