商户次卡列表
<h5>接口使用描述</h5>
<pre><code>商户次卡列表</code></pre>
<h5>接口地址</h5>
<pre><code>接口地址：http(s)://api.liantuofu.com/open/timescard/timesCardList</code></pre>
<p><br/></p>
<h4>请求参数<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>appId</td>
<td>核心商户编号</td>
<td>string</td>
<td>Y</td>
<td>EW_N2949193174</td>
<td>合作商户编码，用于以后所有接口发起请求时验签使用</td>
</tr>
<tr>
<td>2</td>
<td>sign</td>
<td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
</tr>
<tr>
<td>3</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>用来增加加密验签的复杂度，长度不限制，只限制传递数字，不支持中文，字母，特殊符号。</td>
</tr>
<tr>
<td>4</td>
<td>merchantCode</td>
<td>创建次卡商户编号</td>
<td>string</td>
<td>N</td>
<td>SC_I5640724439</td>
<td>创建次卡商户编号</td>
</tr>
<tr>
<td>5</td>
<td>currentPage</td>
<td>当前页，默认1</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>当前页，默认1</td>
</tr>
<tr>
<td>6</td>
<td>pageSize</td>
<td>每页记录数，默认20</td>
<td>int</td>
<td>N</td>
<td>20</td>
<td>每页记录数，默认20</td>
</tr>
<tr>
<td>7</td>
<td>cardName</td>
<td>次卡名称</td>
<td>string</td>
<td>N</td>
<td>10次卡</td>
<td>次卡名称</td>
</tr>
</tbody>
</table>
<h4>响应参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>code</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>SUCCESS</td>
<td>结果码 SUCCESS：成功 FAILED：失败</td>
</tr>
<tr>
<td>2</td>
<td>msg</td>
<td>结果描述</td>
<td>string</td>
<td>Y</td>
<td>登陆成功</td>
<td>无论是成功或者失败，message都会针对于当前的结果返回响应的结果描述</td>
</tr>
<tr>
<td>3</td>
<td>pageCount</td>
<td>总页数</td>
<td>number</td>
<td>Y</td>
<td>20</td>
<td>总页数</td>
</tr>
<tr>
<td>4</td>
<td>totalCount</td>
<td>总记录数</td>
<td>number</td>
<td>Y</td>
<td>5</td>
<td>总记录数</td>
</tr>
<tr>
<td>5</td>
<td>currentPage</td>
<td>当前页号</td>
<td>number</td>
<td>Y</td>
<td>5</td>
<td>当前页号</td>
</tr>
<tr>
<td>6</td>
<td>pageSize</td>
<td>每页记录数</td>
<td>number</td>
<td>Y</td>
<td>50</td>
<td>每页记录数</td>
</tr>
<tr>
<td>7</td>
<td>items</td>
<td>次卡信息</td>
<td>array</td>
<td>Y</td>
<td>{}</td>
<td>次卡信息</td>
</tr>
</tbody>
</table>
<h4>items</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>cardId</td>
<td>次卡编号</td>
<td>number</td>
<td>Y</td>
<td>5235</td>
<td>次卡编号</td>
</tr>
<tr>
<td>2</td>
<td>buildMerchantCode</td>
<td>创建商户编号</td>
<td>string</td>
<td>Y</td>
<td>SC_I5640724439</td>
<td>创建商户编号</td>
</tr>
<tr>
<td>3</td>
<td>buildMerchantName</td>
<td>创建商户名称</td>
<td>string</td>
<td>Y</td>
<td>烧饼</td>
<td>创建商户名称</td>
</tr>
<tr>
<td>4</td>
<td>brandName</td>
<td>品牌名称</td>
<td>string</td>
<td>Y</td>
<td>烧瓶</td>
<td>品牌名称</td>
</tr>
<tr>
<td>5</td>
<td>title</td>
<td>次卡名称</td>
<td>string</td>
<td>Y</td>
<td>订单</td>
<td>次卡名称</td>
</tr>
<tr>
<td>6</td>
<td>type</td>
<td>次卡类型</td>
<td>string</td>
<td>Y</td>
<td>10次卡11月卡</td>
<td>次卡类型</td>
</tr>
<tr>
<td>7</td>
<td>logo</td>
<td>logo</td>
<td>string</td>
<td>Y</td>
<td>1111</td>
<td>logo</td>
</tr>
<tr>
<td>8</td>
<td>bgImg</td>
<td>背景图</td>
<td>string</td>
<td>Y</td>
<td><a href="http://open.liantuobank.cn/imgPath/club-open/1554797500383.jpg">http://open.liantuobank.cn/imgPath/club-open/1554797500383.jpg</a></td>
<td>背景图</td>
</tr>
<tr>
<td>9</td>
<td>dateType</td>
<td>有效期类型</td>
<td>number</td>
<td>Y</td>
<td>2</td>
<td>0不限日期 1固定日期 2固定时长</td>
</tr>
<tr>
<td>10</td>
<td>beginTime</td>
<td>有效期开始日期</td>
<td>string</td>
<td>Y</td>
<td>2019-03-18 00:00:01</td>
<td>有效期类型为固定日期必有</td>
</tr>
<tr>
<td>11</td>
<td>endTime</td>
<td>有效期结束日期</td>
<td>string</td>
<td>Y</td>
<td>2019-04-16 23:59:59</td>
<td>有效期类型为固定日期必有</td>
</tr>
<tr>
<td>12</td>
<td>fixedTerm</td>
<td>有效天数</td>
<td>number</td>
<td>Y</td>
<td>30</td>
<td>有效期类型为固定时长必有</td>
</tr>
<tr>
<td>13</td>
<td>fixedBeginTerm</td>
<td>延迟起效天数</td>
<td>number</td>
<td>N</td>
<td>5</td>
<td>延迟起效天数 有效期类型为固定时长可能有</td>
</tr>
<tr>
<td>14</td>
<td>receiveCnt</td>
<td>领取数</td>
<td>number</td>
<td>Y</td>
<td>55</td>
<td>领取数</td>
</tr>
<tr>
<td>15</td>
<td>quantity</td>
<td>总库存</td>
<td>number</td>
<td>Y</td>
<td>100</td>
<td>总库存</td>
</tr>
<tr>
<td>16</td>
<td>consumeTimes</td>
<td>核销次数</td>
<td>number</td>
<td>Y</td>
<td>0</td>
<td>领取数</td>
</tr>
<tr>
<td>16</td>
<td>buyUrl</td>
<td>购买链接</td>
<td>string</td>
<td>Y</td>
<td><a href="http://localhost:8070/m/10104677/card.htm?type=17&cardId=5135">http://localhost:8070/m/10104677/card.htm?type=17&cardId=5135</a></td>
<td>购买链接</td>
</tr>
<tr>
<td>16</td>
<td>cardTimeLimits</td>
<td>次卡售卖规格</td>
<td>array</td>
<td>Y</td>
<td>0</td>
<td>次卡售卖规格</td>
</tr>
</tbody>
</table>
<h4>cardTimeLimits</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>id</td>
<td>id标示</td>
<td>number</td>
<td>Y</td>
<td>5235</td>
<td>id标示</td>
</tr>
<tr>
<td>2</td>
<td>times</td>
<td>次数</td>
<td>number</td>
<td>Y</td>
<td>439</td>
<td>次数</td>
</tr>
<tr>
<td>3</td>
<td>price</td>
<td>售价</td>
<td>number</td>
<td>Y</td>
<td>10</td>
<td>售价</td>
</tr>
<tr>
<td>4</td>
<td>originalPrice</td>
<td>原价</td>
<td>number</td>
<td>Y</td>
<td>10</td>
<td>原价</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>random=liantuo123&merchantCode=SC_I5640724439&cardName=10次卡&appId=EW_N5946005323&sign=ef0ac372fb162dd334dd5c757457963d&pageSize=20& currentPage=1</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
"pageCount":3,
"totalCount":5,
"currentPage":1,
"pageSize":2,
"items":[
{
"cardId":5135,
"buildMerchantCode":"SC_I5640724439",
"buildMerchantName":"烧饼",
"brandName":"的订单",
"title":"的订单",
"type":10,
"logo":"http://open.liantuobank.cn/imgPath/club-open/1501993661444.jpg",
"bgImg":"http://open.liantuobank.cn/imgPath/club-open/1554797500383.jpg",
"dateType":2,
"fixedTerm":30,
"fixedBeginTerm":0,
"receiveCnt":0,
"quantity":111,
"consumeTimes":0,
"buyUrl":"http://localhost:8070/m/10104677/card.htm?type=17&cardId=5135",
"cardTimeLimits":[
{
"id":534,
"times":11,
"price":1,
"originalPrice":1
}
]
},
{
"cardId":5098,
"buildMerchantCode":"SC_I5640724439",
"buildMerchantName":"烧饼",
"brandName":"dddd",
"title":"dddd",
"type":10,
"logo":"http://open.liantuobank.cn/imgPath/club-open/1501993661444.jpg",
"bgImg":"http://open.liantuobank.cn/imgPath/club-open/1553776167147.jpg",
"dateType":2,
"fixedTerm":30,
"fixedBeginTerm":0,
"receiveCnt":1,
"quantity":111,
"consumeTimes":-1,
"buyUrl":"http://localhost:8070/m/10104677/card.htm?type=17&cardId=5098",
"cardTimeLimits":[
{
"id":509,
"times":11,
"price":0.01,
"originalPrice":1
}
]
}
],
"code":"SUCCESS",
"msg":"成功"
}</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
"code":"FAILED",
"msg":"appId不能为空"
}</code></pre>