优惠卷列表——汪德宇
<p><strong>简要描述:</strong>
待领取优惠卷列表
<strong>请求URL:</strong></p>
<ul>
<li><code>http://xx.com/resource/web/coupon/login/selectCouponList</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求参数说明:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>用户token</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>列表类型 列表类型:0-待领取,默认; 1-未使用; 2-已使用; 3-已过期 4-可用优惠卷</td>
</tr>
<tr>
<td style="text-align: left;">classIds</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int[ ]</td>
<td>课程id数组</td>
</tr>
<tr>
<td style="text-align: left;">planId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>计划id</td>
</tr>
<tr>
<td style="text-align: left;">cardId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>考试卡id</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code> token:放在requestHeader里
{
"data":{
"pageNum":1,
"pageSize":10,
"type":1
}
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"data": [
{
"total": 0,
"couponName": "满0减20",
"couponRuleId": 13,
"money": 20,
"useId": 0,
"endDate": "2019-01-05",
"couponRange": "计划通用",
"userCouponId": 4,
"couponId": 7,
"type": 0,
"useStyle": 0,
"startDate": "2019-01-04"
}
],
"message": {
"errinfo": "success",
"errcode": 200
}
}</code></pre>
<p><strong>返回参数说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">int</td>
<td>优惠卷id</td>
</tr>
<tr>
<td style="text-align: left;">couponName</td>
<td style="text-align: left;">string</td>
<td>优惠卷名称</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">int</td>
<td>优惠卷金额</td>
</tr>
<tr>
<td style="text-align: left;">startDate</td>
<td style="text-align: left;">string</td>
<td>有效期限开始时间</td>
</tr>
<tr>
<td style="text-align: left;">endDate</td>
<td style="text-align: left;">string</td>
<td>有效期限结束时间</td>
</tr>
<tr>
<td style="text-align: left;">total</td>
<td style="text-align: left;">int</td>
<td>满多少</td>
</tr>
<tr>
<td style="text-align: left;">useStyle</td>
<td style="text-align: left;">int</td>
<td>使用类型 0计划类型,1具体计划,2课程类型,3全通用</td>
</tr>
<tr>
<td style="text-align: left;">useId</td>
<td style="text-align: left;">int</td>
<td>具体适用数据(0公需,1专业,2综合,3通用)</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>优惠券类型(0满减,1通用)</td>
</tr>
<tr>
<td style="text-align: left;">couponRange</td>
<td style="text-align: left;">string</td>
<td>使用范围</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态(0待使用,1已使用,2已锁定)</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">string</td>
<td>使用说明</td>
</tr>
</tbody>
</table>
<p><strong>错误码说明</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">访问正常</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td style="text-align: left;">访问错误</td>
</tr>
<tr>
<td style="text-align: left;">897</td>
<td style="text-align: left;">用户不存在</td>
</tr>
<tr>
<td style="text-align: left;">99997</td>
<td style="text-align: left;">缺少必要参数</td>
</tr>
</tbody>
</table>
<p>======================================================================================
<strong>简要描述:</strong>
可用优惠卷列表
<strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>列表类型:0-待领取,默认; 1-未使用; 2-已使用; 3-已过期 4-可用优惠卷</td>
</tr>
<tr>
<td style="text-align: left;">thistype</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>1-课程 2-计划 3-考试卡(取通用优惠卷)</td>
</tr>
<tr>
<td style="text-align: left;">userPlanId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>用户计划id (计划时必传)</td>
</tr>
<tr>
<td style="text-align: left;">cids</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int数组</td>
<td>课程id数组 (课程时必传)</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户token,放入header里</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>订单id</td>
</tr>
<tr>
<td style="text-align: left;">eid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>考试卡id 类型是考试卡时必传</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code> {
"data": {
"type":4,
"thistype":1,
"cids":[22]
}
}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"data": [
{
"total": 0,
"couponName": "满0减20",
"couponRuleId": 13,
"money": 20,
"useId": 0,
"endDate": "2019-01-05",
"couponRange": "计划通用",
"userCouponId": 4,
"couponId": 7,
"type": 0,
"useStyle": 0,
"startDate": "2019-01-04"
}
],
"message": {
"errinfo": "success",
"errcode": 200
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">int</td>
<td>用户关联优惠卷的id</td>
</tr>
<tr>
<td style="text-align: left;">couponName</td>
<td style="text-align: left;">string</td>
<td>优惠卷名称</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">int</td>
<td>优惠卷面值</td>
</tr>
<tr>
<td style="text-align: left;">startDate</td>
<td style="text-align: left;">string</td>
<td>有效期开始时间</td>
</tr>
<tr>
<td style="text-align: left;">endDate</td>
<td style="text-align: left;">string</td>
<td>有效期结束时间</td>
</tr>
<tr>
<td style="text-align: left;">isUse</td>
<td style="text-align: left;">int</td>
<td>是否可以使用 0-不能 1-能</td>
</tr>
<tr>
<td style="text-align: left;">useStyle</td>
<td style="text-align: left;">int</td>
<td>使用类型(0计划类型,1具体计划,2课程类型,3全通用)</td>
</tr>
<tr>
<td style="text-align: left;">useId</td>
<td style="text-align: left;">int</td>
<td>具体适用数据(0公需,1专业,2综合,3通用)</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">int</td>
<td>优惠券类型(0满减,1通用)</td>
</tr>
<tr>
<td style="text-align: left;">total</td>
<td style="text-align: left;">int</td>
<td>满多少</td>
</tr>
<tr>
<td style="text-align: left;">couponRange</td>
<td style="text-align: left;">string</td>
<td>使用范围</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">string</td>
<td>使用说明</td>
</tr>
</tbody>
</table>
<p><strong>错误码说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">3003</td>
<td style="text-align: left;">未登录</td>
</tr>
<tr>
<td style="text-align: left;">99997</td>
<td style="text-align: left;">缺少必要参数</td>
</tr>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">访问正常</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td style="text-align: left;">访问错误</td>
</tr>
</tbody>
</table>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>