匡佳华 / API-Interfaces · Commits

Go to a project

Authored by mingdan.ge
Commit 31874eacc782a98e47be4ad793375a291c2a11d9 1 parent 8abe51e8

礼品卡

Inline Side-by-side
Showing 2 changed files with 263 additions and 0 deletions
  1 +## 1、获取礼品卡列表
  2 +
  3 +获取礼品卡列表 (**method=app.giftcard.list**)
  4 +
  5 +
  6 +**请求参数**
  7 +
  8 +| 参数名称 | 参数类型 |可否为空 |示例 | 备注 |
  9 +| ---------|:--------:| --------:|-----:|-----:|------:|
  10 +|uid|int | 否 |500027362 |礼品卡号 |
  11 +|status|int | 是 | |1-可使用,2-已冻结,3-已过期,4-已用完 |
  12 +
  13 +
  14 +**注意**，通用的头部没有列出。
  15 +
  16 +**请求示例：**
  17 +http://localhost:8090/gateway?method=app.giftcard.list&debug=XYZ&uid=500027362
  18 +
  19 +code为200即为成功，否则是失败。 响应JSON格式如下所示:
  20 +```json
  21 +{
  22 + "alg": "SALT_MD5",
  23 + "code": 200,
  24 + "data":[
  25 + {
  26 + "desc": "已冻结",
  27 + "giftCardInfoBOList": [
  28 + {
  29 + "activateTime": 1504152032,
  30 + "activateUid": 500027362,
  31 + "amount": 600,
  32 + "cardCode": "LPK00500000012",
  33 + "endTime": 1506942032,
  34 + "id": 30,
  35 + "name": "卡片12",
  36 + "remainAmount": 100,
  37 + "status": 50
  38 + }
  39 + ],
  40 + "type": "2"
  41 + },
  42 + {
  43 + "desc": "已用完",
  44 + "giftCardInfoBOList": [
  45 + {
  46 + "activateTime": 1504152032,
  47 + "activateUid": 500027362,
  48 + "amount": 600,
  49 + "cardCode": "LPK00500000026",
  50 + "endTime": 1506942032,
  51 + "id": 46,
  52 + "name": "卡片26",
  53 + "remainAmount": 100,
  54 + "status": 70
  55 + }
  56 + ],
  57 + "type": "4"
  58 + },
  59 + {
  60 + "desc": "可使用",
  61 + "giftCardInfoBOList": [
  62 + {
  63 + "activateTime": 1504152032,
  64 + "activateUid": 500027362,
  65 + "amount": 600,
  66 + "cardCode": "LPK00500000011",
  67 + "endTime": 1506942032,
  68 + "id": 28,
  69 + "name": "卡片11",
  70 + "remainAmount": 100,
  71 + "status": 40
  72 + },
  73 + {
  74 + "activateTime": 1504142032,
  75 + "activateUid": 500027362,
  76 + "amount": 600,
  77 + "cardCode": "LPK00500000009",
  78 + "endTime": 1506942032,
  79 + "id": 24,
  80 + "name": "卡片9",
  81 + "remainAmount": 100,
  82 + "status": 40
  83 + }
  84 + ],
  85 + "type": "1"
  86 + },
  87 + {
  88 + "desc": "已过期",
  89 + "giftCardInfoBOList": [
  90 + {
  91 + "activateTime": 1500152032,
  92 + "activateUid": 500027362,
  93 + "amount": 600,
  94 + "cardCode": "LPK00500000027",
  95 + "endTime": 1506942032,
  96 + "id": 48,
  97 + "name": "卡片27",
  98 + "remainAmount": 100,
  99 + "status": 60
  100 + }
  101 + ],
  102 + "type": "3"
  103 + }
  104 + ] ,
  105 + "md5": "3821b8603e9e240a7d619c69ebfba96a",
  106 + "message": "操作成功"
  107 +}
  108 +
  109 +```
  1 +## 1、获取礼品卡分页列表
  2 +
  3 +获取礼品卡列表 (**method=app.giftcard.pagelist**)
  4 +
  5 +
  6 +**请求参数**
  7 +
  8 +| 参数名称 | 参数类型 |可否为空 |示例 |默认值 | 备注 |
  9 +| ---------|:--------:| --------:|-----:|------:|-----:|------:|
  10 +|uid|int | 否 |123456 | | |
  11 +|status|int|否 | 1 | |1-可使用,2-已冻结,3-已过期,4-已用完|
  12 +|page|int |是 |1 | 1 | |
  13 +|limit|int |是 |10 | 10| |
  14 +
  15 +
  16 +**注意**，通用的头部没有列出。
  17 +
  18 +**请求示例：**
  19 +http://localhost:8080/gateway?method=app.giftcard.pagelist&debug=XYZ&uid=123456&status=1&page=1&limit=20
  20 +
  21 +code为200即为成功，否则是失败。 响应JSON格式如下所示:
  22 +```json
  23 +{
  24 + "alg": "SALT_MD5",
  25 + "code": 200,
  26 + "data": {
  27 + "currPage": 3,
  28 + "currTotal": 9,
  29 + "giftCardInfoBOList": [
  30 + {
  31 + "activateTime": 1504152032,
  32 + "activateUid": 500027364,
  33 + "amount": 600,
  34 + "cardCode": "LPK00500000022",
  35 + "dateStr": "2017.08.31-2017.10.02",
  36 + "endTime": 1506942032,
  37 + "id": 58,
  38 + "name": "卡片22",
  39 + "remainAmount": 100,
  40 + "status": 40
  41 + },
  42 + {
  43 + "activateTime": 1504152032,
  44 + "activateUid": 500027364,
  45 + "amount": 600,
  46 + "cardCode": "LPK00500000023",
  47 + "dateStr": "2017.08.31-2017.10.02",
  48 + "endTime": 1506942032,
  49 + "id": 60,
  50 + "name": "卡片23",
  51 + "remainAmount": 100,
  52 + "status": 40
  53 + },
  54 + {
  55 + "activateTime": 1504151032,
  56 + "activateUid": 500027364,
  57 + "amount": 500,
  58 + "cardCode": "LPK00500000005",
  59 + "dateStr": "2017.08.31-2017.10.01",
  60 + "endTime": 1506842032,
  61 + "id": 16,
  62 + "name": "卡片5",
  63 + "remainAmount": 100,
  64 + "status": 40,
  65 + "willExpire": "即将过期"
  66 + },
  67 + {
  68 + "activateTime": 1504151032,
  69 + "activateUid": 500027364,
  70 + "amount": 500,
  71 + "cardCode": "LPK00500000025",
  72 + "dateStr": "2017.08.31-2017.10.01",
  73 + "endTime": 1506842032,
  74 + "id": 44,
  75 + "name": "卡片25",
  76 + "remainAmount": 100,
  77 + "status": 40,
  78 + "willExpire": "即将过期"
  79 + },
  80 + {
  81 + "activateTime": 1504150032,
  82 + "activateUid": 500027364,
  83 + "amount": 100,
  84 + "cardCode": "LPK00500000001",
  85 + "dateStr": "2017.08.31-2017.09.30",
  86 + "endTime": 1506742032,
  87 + "id": 8,
  88 + "name": "棉花用的谁抢杀谁",
  89 + "remainAmount": 50,
  90 + "status": 40,
  91 + "willExpire": "即将过期"
  92 + },
  93 + {
  94 + "activateTime": 1504150032,
  95 + "activateUid": 500027364,
  96 + "amount": 200,
  97 + "cardCode": "LPK00500000002",
  98 + "dateStr": "2017.08.31-2017.09.30",
  99 + "endTime": 1506742032,
  100 + "id": 10,
  101 + "name": "棉花用的谁抢灭谁",
  102 + "remainAmount": 200,
  103 + "status": 40,
  104 + "willExpire": "即将过期"
  105 + },
  106 + {
  107 + "activateTime": 1504150032,
  108 + "activateUid": 500027364,
  109 + "amount": 200,
  110 + "cardCode": "LPK00500000003",
  111 + "dateStr": "2017.08.31-2017.09.30",
  112 + "endTime": 1506742032,
  113 + "id": 12,
  114 + "name": "33333",
  115 + "remainAmount": 100,
  116 + "status": 40,
  117 + "willExpire": "即将过期"
  118 + },
  119 + {
  120 + "activateTime": 1504150032,
  121 + "activateUid": 500027364,
  122 + "amount": 400,
  123 + "cardCode": "LPK00500000004",
  124 + "dateStr": "2017.08.31-2017.09.30",
  125 + "endTime": 1506742032,
  126 + "id": 14,
  127 + "name": "卡片4",
  128 + "remainAmount": 100,
  129 + "status": 40,
  130 + "willExpire": "即将过期"
  131 + },
  132 + {
  133 + "activateTime": 1504150032,
  134 + "activateUid": 500027364,
  135 + "amount": 400,
  136 + "cardCode": "LPK00500000024",
  137 + "dateStr": "2017.08.31-2017.09.30",
  138 + "endTime": 1506742032,
  139 + "id": 42,
  140 + "name": "卡片24",
  141 + "remainAmount": 100,
  142 + "status": 40,
  143 + "willExpire": "即将过期"
  144 + }
  145 + ],
  146 + "limit": 9,
  147 + "pageSize": 0,
  148 + "total": 27
  149 + },
  150 + "md5": "3ad431ca76d80aa8e8bf3ed4c9835e3c",
  151 + "message": "操作成功"
  152 +}
  153 +
  154 +```