card_info_svr/docs/api.md

卡牌游戏接口说明

一. 说明

所有接口均需上传sessionid

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

{
    "errcode": 0, //0:成功
    "errmsg": "", //错误描述
    "data": {}, 	// 数据
}

二. 客户端接口列表

1. 玩家资料

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

字段	说明
accountid	帐号id

3. Response: JSON

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  // 免费到期时间   
}]

3. 可用英雄列表

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

字段	说明
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)

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

4. 自定义卡组列表

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

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

3. Response: JSON

[{
    id: '',												// 卡组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参数

字段	说明
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: 代币购买 2: 试用
moneyid	代币的item id

3. Response: JSON

根据errcode判断成功or失败

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参数

字段	说明
moneyid	代币的item id
count	试用数量

3. Response: JSON

{
    exp: 1022,		// 当前经验值
    exp_POST: 100, // 本次获得的经验
    level: 1		  // 当前等级
}

三. 服务端接口列表

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

1. Method: POST
2. URI:

字段	说明
accountid	帐号id

3. Response: JSON