card_info_svr/docs/api.md

卡牌游戏接口说明

一. 说明

所有接口均需上传sessionid

通用返回JSON结构, 接口Response的数据结构说明只包含data部分

{
    "errcode": 0, //0:成功 2: 缺少必要参数(accountid, sessionid) 4: 帐号被封, 5: 帐号未找到 100: 所有未定义的错误
    "errmsg": "", //错误描述
    "data": {}, 	// 数据
}

二. 客户端接口列表

1. 玩家资料

1. Method: POST
2. URI: /api/:accountid/uinfo

字段	说明
accountid	帐号id

3. Response: JSON

{
    accountid: '',
    cards: [number],
    heros: [{
        heroid: number,
        owned: true,                // 是否已拥有
        usetype: 1,             // 赛季专属, 0: 通用, 1: 赛季排位专用, 2: 匹配专用
        level: number,              // 等级
        exp: number,            // 当前的经验值
        ban: false,							// 是否被禁用
        free: false,              // 是否免费
        trial: false,							// 是否是试用
        trial_expire: 1609919293,  // 试用到期时间, 0: 说明是永久 
    }],
    moneys: {
        'coin': 0,      // 金币
        'diamond': 0,   // 钻石
        'hero_shard': 0, // 通用英雄碎片
        'hero_exp': 0,  // 通用英雄经验
        'hero_shard_heroid': 0, // 英雄专用碎片
        'hero_exp_heroid': 0, // 英雄专用经验
        'card_scroll': 0, //抽卡卷轴
    },
    normal_stat: [0, 0, 0, 0] //匹配: 胜利场数, 失败场数, 平局场数, 掉线场数
    season_rank: 1  // 当前赛季排名
    match_score: 1000    //当前匹配分, 用于匹配时上传
    season_score: 1000 // 排位分, 用于显示
    season_data: {} // 当前赛季统计信息, 内容同接口11
}

2. 可用卡牌信息

1. Method: POST
2. URI: /api/:accountid/cards

字段	说明
accountid	帐号id

3. Response: JSON

说明: 匹配模式可以用的卡: (owned == true || (free == true && not expired)) && (usetype == 0 || usetype == 2) 赛季排位模式可以用的卡: (owned == true || (free == true && not expired)) && (usetype == 0 || usetype == 1)

[{
    cardid: 1022,					// 卡牌id
    owned: true,				// 是否已拥有
    ban: false,					// 是否被禁用
    usetype: 1,    			// 赛季专属, 0: 通用, 1: 赛季排位专用, 2: 匹配专用
    free: false,			  // 是否免费
    free_expire: 1609919293  // 免费到期时间  
    time:1609919293     // 该卡第一次解锁时间 
}]

3. 可用英雄列表

这个接口用户信息中的英雄列表最大的不同, 这里返回所有可用英雄, 用户信息中只返回永久免费和玩家拥有的英雄

1. Method: POST
2. URI: /api/:accountid/heros

字段	说明
accountid	帐号id

3. Response: JSON

说明: 匹配模式可以用的英雄: (owned == true || (trial== true && not expired)) && (usetype == 0 || usetype == 2) 赛季排位模式可以用的英雄: (owned == true || (trial== true && not expired)) && (usetype == 0 || usetype == 1)

[{
    heroid: 1022,				// 英雄id
    owned: true,				// 是否已拥有
    ban: false,					// 是否被禁用
    usetype: 1,    			// 赛季专属, 0: 通用, 1: 赛季排位专用, 2: 匹配专用
    ban: false,							// 是否被禁用
    free: false,			  // 是否免费
    trial: false,				// 是否试用
    trial_expire: 1609919293  // 试用到期时间, 0: 说明是永久
    level: 1,						// 等级
  	exp: 0,							// 当前的经验值
    time: 1609919293          // 该英雄解锁时间 
    slot: 1,          // 已解锁卡槽数量
}]

4. 自定义卡组列表

1. Method: POST
2. URI: /api/:accountid/card_group/:heroid

字段	说明
accountid	帐号id
heroid	英雄id, 不传的话, 获取该玩家所有可用卡组

3. Response: JSON

[{
    gid: '',											// 卡组id
    heroid: '',                   // 英雄id
    selected: true,								// 当前选择的卡组
    isdefault: false,							// 是否是默认卡组, 默认卡组不能编辑
    cards: [{
        cardid: '',               // 卡牌id
        owned: true,              // 是否已拥有
        ban: false,               // 是否被禁用
        usetype: 1,               // 赛季专属, 0: 通用, 1: 赛季排位专用, 2: 匹配专用
        free: false,              // 是否免费
        free_expire: 1609919293   // 免费到期时间   
    }]
}]

5. 保存卡组

1. Method: POST
2. URI: /api/:accountid/card_group/save/:gid

字段	说明
accountid	帐号id
gid	卡组id, 新卡组传 'new'

POST参数

字段	说明
heroid	英雄id
selected	是否设为选中
cards	[cardid] 卡牌id的数组

3. Response: JSON

根据errcode判断成功or失败

6. 删除卡组

1. Method: POST
2. URI: /api/:accountid/card_group/delete/:gid

字段	说明
accountid	帐号id
gid	卡组id, 不能为空

3. Response: JSON

根据errcode判断成功or失败

7. 解锁英雄

1. Method: POST
2. URI: /api/:accountid/hero/unlock/:heroid

字段	说明
accountid	帐号id
heroid	英雄id

POST参数

字段	说明
type	类型 0: 碎片, 1: 试用

3. Response: JSON

说明: 解锁成功的话, 会返回当前解锁英雄的数据

[{
    heroid: 1022,				// 英雄id
    owned: true,				// 是否已拥有
    ban: false,					// 是否被禁用
    usetype: 1,    			// 赛季专属, 0: 通用, 1: 赛季排位专用, 2: 匹配专用
    free: false,			  // 是否免费
    trial: false,				// 是否是试用
    trial_expire: 1609919293  // 试用到期时间, 0: 说明是永久
    level: 1,						// 等级
  	exp: 0,							// 当前的经验值
}]

8. 抽卡

1. Method: POST
2. URI: /api/:accountid/card/draw/:count

字段	说明
accountid	帐号id
count	抽卡数量

3. Response: JSON

[{
    cardid: 1022,		// 卡牌id
    isnew: true,		// 是否是新获得的卡
    expdust: '',		// 分解可获得的英雄经验的item id
    dustcount: 100	// 可获得数量 
}]

9. 对战记录列表

1. Method: POST
2. URI: /api/:accountid/records

字段	说明
accountid	帐号id

3. Response: JSON

10. 升级英雄

1. Method: POST
2. URI: /api/:accountid/hero/update/:heroid

字段	说明
accountid	帐号id
heroid	英雄id

POST参数

字段	说明
items	使用代币类型和数量, 格式 money0:count|money1:count1

3. Response: JSON

{
    exp: 1022,		// 升级后当前经验值
    level: 1,		  // 升级后的等级
    exp_gain: 100, // 本次升级一共获得的经验
}

11. 赛季统计信息

1. Method: POST
2. URI: /api/:accountid/season_data

字段	说明
accountid	帐号id

3. Response: JSON

{
  "0": 477, //最高伤害
  "1": 62,  // 最高承伤
  "2": 289, // 最高总战力
  "3": 150, // 最高单体战力
  "4": 6,   // 最高每局胡牌数
  "5": 0,   // 每局最多送给队友抽牌数
  "0_total": 1071.3,  // 所有伤害积分
  "1_total": 86,    // 所有承伤积分
  "2_total": 1302,  // 最高总战力积分
  "3_total": 1325,  // 单体战力总积分
  "4_total": 390,   // 所有胡牌数
  "5_total": 0,     // 赠送牌数 
  "honor_ap": 4174.3, // 历史战功和
  "mvp_ap": 4174.3,   // mvp积分和
  "win": 5,           // 胜利场数,
  "lost": 0,          // 失败场数
  "score": 1281.061909262327,   // 当前天体分
  "match_score": 2921.59286389349 // 当前匹配分
}

12. 获取邮件附件

1. Method: POST
2. URI: /api/:accountid/mail_attachment

字段	说明
accountid	帐号id

POST参数

字段	说明
mail_ids	邮件id列表以","分割

3. Response: JSON

[ //附件列表
  {
    "itemid": 0, //道具id
    "itemnum": 0, //道具数量
  },
]

13. 获取物品列表

1. Method: POST
2. URI: /api/:accountid/items

字段	说明
accountid	帐号id

3. Response: JSON

[ //物品列表
  {
    "itemid": 0, //道具id
    "itemnum": 0, //道具数量
  },
]

14. 使用物品

1. Method: POST
2. URI: /api/:accountid/useitem

字段	说明
accountid	帐号id

POST参数

字段	说明
itemid	物品id
count	使用数量

3. Response: JSON

[ //物品列表
  {
    "itemid": 0, //道具id
    "itemnum": 0, //道具数量
  },
]

15. 解锁英雄卡槽

1. Method: POST
2. URI: /api/:accountid/hero/unlockslot/:heroid

字段	说明
accountid	帐号id
heroid	英雄id

3. Response: JSON

三. 服务端接口列表

1. 上传对战记录(服务端调用)

1. Method: POST
2. URI:

字段	说明
accountid	帐号id

3. Response: JSON