This commit is contained in:
2026-09-02 19:57:55 +08:00
parent 63b1eb772e
commit 552a5da15a
24 changed files with 1559 additions and 140 deletions
@@ -27,10 +27,25 @@ namespace Assets.MyGame.Scripts.Net.API.GameConfig_SubClass
[Serializable]
public class LotteryPrize
{
public string type;
public long count;
/// <summary>奖项唯一标识ID(如"A001"、"B002",用于唯一性控制:同一用户不能重复抽中)</summary>
public string prizeId;
/// <summary>奖项名称(用于前端展示)</summary>
public string name;
/// <summary>奖项图标地址</summary>
public string icon;
/// <summary>奖励类型 1=金币,2=钻石,3=道具,4=道具碎片</summary>
public int type;
/// <summary>奖励数量</summary>
public long count;
/// <summary>道具/碎片编号(type=3或4时使用)</summary>
public string otherId;
/// <summary>道具详情</summary>
public BaseProduct product;
/// <summary>在该等级内的抽中奖权重</summary>
public int weight;
/// <summary>该奖项总库存数量(全局,0=无限库存)</summary>
public int totalCount;
/// <summary>已抽中数量(运行时统计,用于判断库存是否充足)</summary>
public int drawnCount;
}
}
@@ -13,6 +13,10 @@ namespace Assets.MyGame.Scripts.Net.API
{
/// <summary>总开关</summary>
public bool isEnabled;
/// <summary>排行榜维护中开关,开启后前端请求排行榜会提示维护中</summary>
public bool isMaintaining;
/// <summary>维护中提示文案</summary>
public string maintainingMessage;
/// <summary>排行榜奖励分组列表</summary>
public List<RankingRewardGroup> groups;
}
@@ -1,3 +1,5 @@
using Assets.MyGame.Scripts.Net.API.GameConfig_SubClass;
using Assets.MyGame.Scripts.Net.API.UserData_SubClass;
using System;
using System.Collections.Generic;
@@ -6,7 +8,7 @@ namespace Assets.MyGame.Scripts.Net.APIResponses
// ============================================================
// 补充响应类:以下接口暂未接入业务,但已注册到 APIManager,
// 方便后续快速接入。按 swagger 路径分组放置。
// 字段类型为推测,接入业务前请按后端实际返回再调整。
// 字段已按 2026-09-02 后端 swagger(/swagger/v1/swagger.json)校对同步。
// ============================================================
// ---------------- /api/User/GetUserAssets ----------------
@@ -14,63 +16,35 @@ namespace Assets.MyGame.Scripts.Net.APIResponses
[Serializable]
public class UserAssetsResponse
{
public string userId;
public long gold;
public int diamond;
public long safeBoxGold;
public int level;
public long exp;
public int vipLevel;
public List<PropInfo> props;
public List<BaseProductCount> props;
}
// ---------------- /api/User/GetFishingReturnInfo ----------------
/// <summary>捕鱼返利信息</summary>
[Serializable]
public class FishingReturnInfoResponse
public class FishingReturnDto
{
/// <summary>待领取返利金币</summary>
public long pendingGold;
/// <summary>累计返利金币</summary>
public long totalGold;
/// <summary>上次结算时间</summary>
public long lastSettleTime;
/// <summary>是否可领取</summary>
public bool canClaim;
/// <summary>今日捕鱼消耗金币</summary>
public long todayConsume;
/// <summary>昨日捕鱼消耗金币</summary>
public long yesterdayConsume;
/// <summary>是否已领取昨日返利</summary>
public bool isClaimed;
/// <summary>可领取的金币数量</summary>
public long canClaimGold;
}
// ---------------- /api/User/ClaimFishingReturn ----------------
/// <summary>领取捕鱼返利响应</summary>
[Serializable]
public class ClaimFishingReturnResponse
public class ClaimFishingReturnDto
{
/// <summary>本次领取金币</summary>
public long claimedGold;
/// <summary>领取时间</summary>
public long claimTime;
}
// ---------------- /api/ActivityConfig/lotteryConfig & /api/Lottery/Config ----------------
/// <summary>抽奖活动配置</summary>
[Serializable]
public class LotteryConfigResponse
{
public int lotteryId;
public string name;
public long startTime;
public long endTime;
public List<LotteryPrizeInfo> prizes;
}
[Serializable]
public class LotteryPrizeInfo
{
public int prizeId;
public string prizeName;
public int prizeType; // 1=金币 2=钻石 3=道具
public int count;
public int weight; // 权重
public string icon;
/// <summary>领取的金币数量</summary>
public long gold;
/// <summary>结果消息</summary>
public string message;
}
// ---------------- /api/Lottery/Draw ----------------
@@ -78,65 +52,95 @@ namespace Assets.MyGame.Scripts.Net.APIResponses
[Serializable]
public class LotteryDrawResponse
{
public int prizeId;
public string prizeName;
public int prizeType;
public int count;
public long drawTime;
/// <summary>奖品Id</summary>
public string prizeId;
/// <summary>奖品名称</summary>
public string name;
/// <summary>奖品类型 1=金币 2=钻石 3=道具</summary>
public int type;
/// <summary>数量</summary>
public long count;
/// <summary>关联Id</summary>
public string otherId;
/// <summary>消耗</summary>
public long cost;
}
// ---------------- /api/Lottery/UserStatus ----------------
/// <summary>用户抽奖状态</summary>
/// <summary>用户抽奖状态实体</summary>
[Serializable]
public class LotteryUserStatusResponse
public class LotteryUserStatus
{
public int lotteryId;
public int freeCount; // 剩余免费次数
public int paidCount; // 剩余付费次数
public long lastDrawTime;
}
// ---------------- /api/Lottery/DrawnPrizes ----------------
/// <summary>已抽奖项记录</summary>
[Serializable]
public class LotteryDrawnPrizeItem
{
public int prizeId;
public string prizeName;
public int prizeType;
public int count;
public long drawTime;
public string id;
public bool isDelete;
public OptionUserInfo createInfo;
/// <summary>用户ID(每个用户一条状态记录)</summary>
public string userId;
/// <summary>用户已抽中的奖项ID列表(唯一性控制)</summary>
public List<string> drawnPrizeIds;
/// <summary>用户总抽奖次数</summary>
public int totalDrawCount;
/// <summary>用户活动是否结束(已抽完所有奖项)</summary>
public bool isFinished;
}
// ---------------- /api/SummonCard/use ----------------
/// <summary>使用召唤卡响应</summary>
[Serializable]
public class SummonCardUseResponse
{
public bool success;
public string message;
public List<PropInfo> drops; // 掉落道具列表
}
// 返回 StringBaseResponse(纯字符串),无需独立响应类。
// ---------------- /api/Dict/GetByCode ----------------
/// <summary>字典单条</summary>
// ---------------- /api/Dict/GetByCode、GetListByCode ----------------
/// <summary>字典实体</summary>
[Serializable]
public class DictItem
public class SystemDic
{
public string code;
public string id;
public bool isDelete;
public OptionUserInfo createInfo;
public string parentId;
public string name;
public int order;
public string icon;
public string value;
public string code;
public string remark;
public string remark1;
}
// ---------------- /api/Hall/GetBattleOrderLevelStatus ----------------
/// <summary>战令各等级奖励领取状态</summary>
/// <summary>战令各等级奖励领取状态响应</summary>
[Serializable]
public class BattleOrderLevelStatusResponse
{
/// <summary>当前等级</summary>
public int currentLevel;
public List<int> normalReceivedLevels; // 普通奖励已领取等级
public List<int> luxuryReceivedLevels; // 豪华奖励已领取等级
public List<int> supremeReceivedLevels; // 至尊奖励已领取等级
/// <summary>当前经验</summary>
public long currentExp;
/// <summary>是否已购买豪华版</summary>
public bool isLuxury;
/// <summary>是否已购买至尊版</summary>
public bool isSupreme;
/// <summary>各等级领取状态列表</summary>
public List<BattleOrderLevelStatus> levelStatusList;
}
/// <summary>单个战令等级领取状态</summary>
[Serializable]
public class BattleOrderLevelStatus
{
/// <summary>等级</summary>
public int level;
/// <summary>升级所需经验</summary>
public long exp;
/// <summary>普通奖励状态 1=不满足 2=未领取 3=已领取</summary>
public int normalStatus;
/// <summary>普通奖励列表</summary>
public List<GiftConfig> normalGiftList;
/// <summary>豪华奖励状态 0=未购买 1=不满足 2=未领取 3=已领取</summary>
public int luxuryStatus;
/// <summary>豪华奖励列表</summary>
public List<GiftConfig> luxuryGiftList;
/// <summary>至尊奖励状态 0=未购买 1=不满足 2=未领取 3=已领取</summary>
public int supremeStatus;
/// <summary>至尊奖励列表</summary>
public List<GiftConfig> supremeGiftList;
}
}