add coupons bag api doc
Showing
1 changed file
with
109 additions
and
0 deletions
促销/礼包.md
0 → 100644
1 | +#礼包接口 | ||
2 | + | ||
3 | +## 接口列表 | ||
4 | +| 接口名称 | 接口描述 | | ||
5 | +| --------| -------- | | ||
6 | +|[app.giftBag.getCouponsBagList](#2)|查询礼包列表信息| | ||
7 | +|[app.giftBag.drawCouponsBag](#3)|用户领取礼包| | ||
8 | + | ||
9 | + | ||
10 | +## 接口描述 | ||
11 | + | ||
12 | +### 1、查询礼包的列表信息(app.giftBag.getCouponsBagList) | ||
13 | + | ||
14 | +#### 请求参数 | ||
15 | +| Param Name | Param Type | Required | Param Value | Desc | | ||
16 | +| :-- | --: | --: | --: | --: | | ||
17 | +| method | String | true |app.giftBag.getCouponsBagList| 请求方法| | ||
18 | +| uid | int | true | 7893817 |用户ID | | ||
19 | + | ||
20 | +#### 响应内容 | ||
21 | +```json | ||
22 | +{ | ||
23 | + "alg": "SALT_MD5", | ||
24 | + "code": 200, | ||
25 | + "data": [ | ||
26 | + { | ||
27 | + "id" : 2, | ||
28 | + "name" : "银卡升级礼包", | ||
29 | + "startTime": "2018-04-10 12:00:00", -- 领取开始时间 | ||
30 | + "endTime": "2018-04-17 23:59:59", -- 领取截止时间 | ||
31 | + "status": 1, -- 是否已领取 未领取:0,已领取:1; | ||
32 | + "notExpired": true -- 未过期:true,过期:false; | ||
33 | + }, | ||
34 | + { | ||
35 | + "id" : 4, | ||
36 | + "name" : "生日礼包", | ||
37 | + "startTime": "2018-04-10 12:00:00", -- 领取开始时间 | ||
38 | + "endTime": "2018-04-17 23:59:59", -- 领取截止时间 | ||
39 | + "status": 1, -- 是否已领取 未领取:0,已领取:1; | ||
40 | + "notExpired": true -- 未过期:true,过期:false; | ||
41 | + } | ||
42 | + ] | ||
43 | +} | ||
44 | +``` | ||
45 | +### 2、领取礼包(app.giftBag.drawCouponsBag) | ||
46 | + | ||
47 | +#### 请求参数 | ||
48 | +| Param Name | Param Type | Required | Param Value | Desc | | ||
49 | +| :-- | --: | --: | --: | --: | | ||
50 | +| method | String | true |app.giftBag.drawCouponsBag| 请求方法| | ||
51 | +| uid | int | true | 7893817 |用户ID | | ||
52 | +| couponsBagId | int | true |23121 |礼包id| | ||
53 | + | ||
54 | +#### 响应内容 | ||
55 | +```json | ||
56 | +{ | ||
57 | + "alg": "SALT_MD5", | ||
58 | + "code": 200, | ||
59 | + "data": [ | ||
60 | + { | ||
61 | + "couponAmount": 50, | ||
62 | + "couponCode": "", | ||
63 | + "couponName": "4月生日券-满199减50", | ||
64 | + "endTime": "2017-04-30 09:45:40", | ||
65 | + "id": 2030, | ||
66 | + "startTime": "2013-04-01 00:00:00", | ||
67 | + "status": 1, | ||
68 | + "useLimit": "199", | ||
69 | + "useLimitType": "2" | ||
70 | + }, | ||
71 | + { | ||
72 | + "couponAmount": 300, | ||
73 | + "couponCode": "", | ||
74 | + "couponName": "12月生日券-满799减300", | ||
75 | + "endTime": "2017-01-31 09:45:40", | ||
76 | + "id": 2033, | ||
77 | + "startTime": "2013-12-01 00:00:00", | ||
78 | + "status": 1, | ||
79 | + "useLimit": "799", | ||
80 | + "useLimitType": "2" | ||
81 | + }, | ||
82 | + { | ||
83 | + "couponAmount": 50, | ||
84 | + "couponCode": "", | ||
85 | + "couponName": "1月生日券-满199减50", | ||
86 | + "endTime": "2017-01-31 09:45:40", | ||
87 | + "id": 2035, | ||
88 | + "startTime": "2014-01-01 00:00:00", | ||
89 | + "status": 1, | ||
90 | + "useLimit": "199", | ||
91 | + "useLimitType": "2" | ||
92 | + }, | ||
93 | + { | ||
94 | + "couponAmount": 300, | ||
95 | + "couponCode": "", | ||
96 | + "couponName": "1月生日券-满799减300", | ||
97 | + "endTime": "2017-01-31 09:45:40", | ||
98 | + "id": 2038, | ||
99 | + "startTime": "2014-01-01 00:00:00", | ||
100 | + "status": 1, | ||
101 | + "useLimit": "799", | ||
102 | + "useLimitType": "2" | ||
103 | + } | ||
104 | + ], | ||
105 | + "md5": "c957283765172838f577de4228d45a42", | ||
106 | + "message": "请求成功" | ||
107 | +} | ||
108 | +``` | ||
109 | + |
-
Please register or login to post a comment