Authored by chenchao

add coupons bag api doc

  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 +