1

tasks-api.md

@@ -0,0 +1,119 @@
+# 任务系统接口文档
+
+## 概述
+
+任务系统允许玩家完成各种游戏内任务以获得奖励。系统支持多种任务类型，包括日常任务、成就任务等。
+
+## API端点
+
+### 获取所有任务配置
+```
+GET /api/tasks
+```
+
+**响应**
+```json
+[
+  {
+    "id": "login_task_1",
+    "name": "每日登录",
+    "desc": "每日登录游戏",
+    "condition": 1,
+    "value1": 1,
+    "value2": "",
+    "value3": "",
+    "rewardTypes": [0],
+    "rewardNums": [100],
+    "isDailyTask": true,
+    "durationHours": 24
+  },
+  {
+    "id": "win_task_1",
+    "name": "胜利之路",
+    "desc": "获得3场对战胜利",
+    "condition": 3,
+    "value1": 3,
+    "value2": "",
+    "value3": "",
+    "rewardTypes": [0],
+    "rewardNums": [200],
+    "isDailyTask": true,
+    "durationHours": 24
+  }
+]
+```
+
+### 获取玩家任务数据
+```
+GET /api/tasks/{userId}
+```
+
+**响应**
+```json
+{
+  "tasks": [
+    {
+      "taskId": "login_task_1",
+      "assignedTime": 16409952000000000,
+      "expireTime": 16410816000000000,
+      "status": 1,
+      "progress": 1
+    }
+  ],
+  "lastDailyTaskAssigned": 16409952000000000
+}
+```
+
+### 保存玩家任务数据
+```
+POST /api/tasks/{userId}
+```
+
+**请求体**
+```json
+{
+  "tasks": [
+    {
+      "taskId": "login_task_1",
+      "assignedTime": 16409952000000000,
+      "expireTime": 16410816000000000,
+      "status": 1,
+      "progress": 1
+    }
+  ],
+  "lastDailyTaskAssigned": 16409952000000000
+}
+```
+
+**响应**
+```json
+{
+  "success": true,
+  "error": ""
+}
+```
+
+## 枚举值定义
+
+### 任务条件类型 (TaskConditionType)
+| 值 | 名称 | 描述 |
+|---|------|------|
+| 1 | LoginGame | 登入游戏 |
+| 2 | PlayGames | 进行X场对战 |
+| 3 | WinGames | 胜利X场 |
+| 4 | DefeatHeroWithAttributes | 击败Y属性和Z属性的英雄X次 |
+| 5 | SummonHeroWithAttributes | 召唤Y属性和Z属性的英雄X次 |
+| 6 | UseHeroSkillWithAttributes | 使用Y属性和Z属性英雄的技能X次 |
+
+### 任务奖励类型 (TaskRewardType)
+| 值 | 名称 | 描述 |
+|---|------|------|
+| 0 | Coins | 金币 |
+
+### 任务状态 (TaskStatus)
+| 值 | 名称 | 描述 |
+|---|------|------|
+| 0 | Active | 激活 |
+| 1 | Completed | 完成 |
+| 2 | Expired | 过期 |
+| 3 | Claimed | 已领取 |