a

坦克充值活动(2022)/活动页index.md

@@ -21,19 +21,28 @@
 ##### 响应属性
 > 释义详见 `[返回示例]`
 
-|参数名|类型|
+|参数名|类型|说明|
 |:----  |:---- |
-|data.symbol |string |
-|data.level |string |
-|data.amount |int |
-|data.amount_rmb |int/float |
-|data.rewards.reward_id |string |
-|data.rewards.name |string |
-|data.rewards.level |string |
-|data.rewards.reach_amount |string |
-|data.rewards.cycle_type |string |
-|data.rewards.rewardJSON |object |
-|data.is_reached |bool |
+|data.cycle_symbol |string | 充值统计周期的标识符，例如：20221111（日），202211（月），2246（周,即2022年第46周） |
+|data.level |string | 充值`已`达标等级，v1~vn，如未达标，则为null |
+|data.amount |int | 周期充值金额合计（分） |
+|data.amount_rmb |int/float | 周期充值金额合计（元） |
+|data.rewards[N].reward_id |string | 奖励定义信息ID |
+|data.rewards[N].name |string | 例如：500元充值礼包 |
+|data.rewards[N].level |string | 此奖励的要求达标等级 |
+|data.rewards[N].reach_amount |string | 达标所需的周期最低充值总额（分） |
+|data.rewards[N].cycle_type |string | 周期类型，默认为周(week)。其它值有 月(month)、日(date)  |
+|data.rewards[N].rewardJSON |object | 奖励数据 |
+|data.rewards[N].rewardJSON.struct |string | 约定的奖励数据结构类型，便于前端以不同的方式解包数据 |
+|data.rewards[N].rewardJSON.data |object | 此为具体的奖励数据，结构会根据rewardJSON.struct灵活调整。现在暂时只有一种结构 |
+|data.rewards[N].rewardJSON.data[N] |array | 当奖励数据结构为默认时，此data属性为Array类型 |
+|data.rewards[N].rewardJSON.data[N].name |string | 奖品名称（必有字段） |
+|data.rewards[N].rewardJSON.data[N].img |string | 奖品图片（必有字段） |
+|data.rewards[N].rewardJSON.data[N].type |string | 奖品类型（必有字段），有：maskcard-伪装卡、coin-金币 |
+|data.rewards[N].rewardJSON.data[N].cardCode |string | 伪装卡密(只有伪装卡才有此字段)：没有领到奖时，此为空串; 领到伪装卡奖励时，就有卡密 |
+|data.rewards[N].rewardJSON.data[N].cardName |string | 伪装卡名称(只有伪装卡才有此字段)，跟页游后台配置的卡码类型库有关 |
+|data.is_reached |bool | 是否有资格领取 |
+|data.is_received |bool | 是否已领取 |
 
 
 
@@ -44,33 +53,37 @@
     "rs": true,
     "msg": "ok",
     "data": {
-        "cycle_symbol": "2246", //充值统计周期的标识符，例如：20221111（日），202211（月），2246（周 |即2022年第46周）
-        "level": null, //充值达标等级，v1~vn，如未达标，则为null
-        "amount": 0, //周期充值金额合计（分）
-        "amount_rmb": 0, //周期充值金额合计（元）
+        "cycle_symbol": "2246",
+        "level": "v6",
+        "amount": 10100000,
+        "amount_rmb": 101000,
         "rewards": [
             {
-                "reward_id": "1",  //奖励定义信息ID
+                "reward_id": "1",
                 "name": "500元充值礼包",
-                "level": "v1", //此达标等级
-                "reach_amount": "50000", //达标所需的周期最低充值总额（分）
-                "cycle_type": "week",  //周期类型，默认为周(week)。其它值有 月(month)、日(date) 
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(随机场次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"100金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
-                "rewardJSON": {  //奖励数据
-                    "struct": "struct1",  //约定的奖励数据结构类型，便于前端以不同的方式解包数据
-                    "data": [ //此为具体的奖励数据，结构会根据rewardJSON.struct灵活调整。现在暂时是这样的结构
+                "level": "v1",
+                "reach_amount": "50000",
+                "cycle_type": "week",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(随机场次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"5场次\",\"cardCode\":\"\"},{\"name\":\"100金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
+                "rewardJSON": {
+                    "struct": "struct1",
+                    "data": [
                         {
                             "name": "伪装卡(随机场次)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "5场次",
+                            "cardCode": ""
                         },
                         {
                             "name": "100金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false, //是否有资格领取
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             },
             {
                 "reward_id": "2",
@@ -78,22 +91,26 @@
                 "level": "v2",
                 "reach_amount": "100000",
                 "cycle_type": "week",
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(100次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(100次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"100场次\",\"cardCode\":\"\"},{\"name\":\"500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
                 "rewardJSON": {
                     "struct": "struct1",
                     "data": [
                         {
                             "name": "伪装卡(100次)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "100场次",
+                            "cardCode": ""
                         },
                         {
                             "name": "500金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false,
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             },
             {
                 "reward_id": "3",
@@ -101,22 +118,26 @@
                 "level": "v4",
                 "reach_amount": "300000",
                 "cycle_type": "week",
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(300次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"1000金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(300场次)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"300场次\",\"cardCode\":\"\"},{\"name\":\"1000金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
                 "rewardJSON": {
                     "struct": "struct1",
                     "data": [
                         {
-                            "name": "伪装卡(300次)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "name": "伪装卡(300场次)",
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "300场次",
+                            "cardCode": ""
                         },
                         {
                             "name": "1000金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false,
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             },
             {
                 "reward_id": "6",
@@ -124,22 +145,26 @@
                 "level": "v3",
                 "reach_amount": "500000",
                 "cycle_type": "week",
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"2500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"月卡(30天)\",\"cardCode\":\"\"},{\"name\":\"2500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
                 "rewardJSON": {
                     "struct": "struct1",
                     "data": [
                         {
                             "name": "伪装卡(月卡)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "月卡(30天)",
+                            "cardCode": ""
                         },
                         {
                             "name": "2500金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false,
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             },
             {
                 "reward_id": "4",
@@ -147,22 +172,26 @@
                 "level": "v5",
                 "reach_amount": "1000000",
                 "cycle_type": "week",
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"5000金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"月卡(30天)\",\"cardCode\":\"\"},{\"name\":\"5000金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
                 "rewardJSON": {
                     "struct": "struct1",
                     "data": [
                         {
                             "name": "伪装卡(月卡)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "月卡(30天)",
+                            "cardCode": ""
                         },
                         {
                             "name": "5000金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false,
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             },
             {
                 "reward_id": "5",
@@ -170,22 +199,26 @@
                 "level": "v6",
                 "reach_amount": "2000000",
                 "cycle_type": "week",
-                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"},{\"name\":\"7500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\"}]}",
+                "reward_json": "{\"struct\":\"struct1\",\"data\":[{\"name\":\"伪装卡(月卡)\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"maskcard\",\"cardTypeName\":\"月卡(30天)\",\"cardCode\":\"\"},{\"name\":\"7500金币\",\"img\":\"https://pub.ouj.com/xie-h5/guide/power-1@2x.png\",\"type\":\"coin\"}]}",
                 "rewardJSON": {
                     "struct": "struct1",
                     "data": [
                         {
                             "name": "伪装卡(月卡)",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "maskcard",
+                            "cardTypeName": "月卡(30天)",
+                            "cardCode": ""
                         },
                         {
                             "name": "7500金币",
-                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png"
+                            "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                            "type": "coin"
                         }
                     ]
                 },
-                "is_reached": false,
-				"is_received": false //是否已领取
+                "is_received": true,
+                "is_reached": true
             }
         ]
     }

坦克充值活动(2022)/领取奖励.md

@@ -28,10 +28,23 @@
 ``` 
 {
     "rs": true,
-    "msg": "OK",
+    "msg": "领取成功",
     "data": {
         "voucher": "WEEK2246-U1-5E2E7F0ACBDD663376544D154E19DEAEB63C5382",
-		"maskcard": "伪装卡卡密伪装卡卡密伪装卡卡密伪装卡卡密伪装卡卡密"
+        "maskcardList": [
+            {
+                "name": "伪装卡(100次)",
+                "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                "type": "maskcard",
+                "cardTypeName": "100场次",
+                "cardCode": "WOTA04155FB339E89C58A59EC5D7046D"
+            },
+            {
+                "name": "500金币",
+                "img": "https://pub.ouj.com/xie-h5/guide/power-1@2x.png",
+                "type": "coin"
+            }
+        ]
     }
 }
 ```
@@ -42,7 +55,7 @@
     "msg": "您本周的充值总额(1000元)，未达到此奖励门槛，不能领取奖励",
     "data": {
         "voucher": null,
-		"maskcard": null
+		"maskcardList": []
     }
 }
 ```
@@ -53,7 +66,7 @@
     "msg": "您本周的充值总额(0元)未达标，不能领取奖励",
     "data": {
         "voucher": null,
-		"maskcard": null
+		"maskcardList": []
     }
 }
 ```