tcg-server/tasks-api.md

任务系统接口文档

概述

任务系统允许玩家完成各种游戏内任务以获得奖励。系统支持多种任务类型，包括日常任务、成就任务等。

API端点

获取所有任务配置

GET /api/tasks

响应

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

响应

{
  "tasks": [
    {
      "taskId": "login_task_1",
      "assignedTime": 16409952000000000,
      "expireTime": 16410816000000000,
      "status": 1,
      "progress": 1
    }
  ],
  "lastDailyTaskAssigned": 16409952000000000
}

保存玩家任务数据

POST /api/tasks/{userId}

请求体

{
  "tasks": [
    {
      "taskId": "login_task_1",
      "assignedTime": 16409952000000000,
      "expireTime": 16410816000000000,
      "status": 1,
      "progress": 1
    }
  ],
  "lastDailyTaskAssigned": 16409952000000000
}

响应

{
  "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	已领取