我的优惠券
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>我的优惠券
<pre><code class="language-css">请求头中需带上TokenValue字段，传参接收到的token值,用于用户验证</code></pre></li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/v1/coupon/list</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<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;">jsonstr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求字符串</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密钥</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">jsonstr参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>状态（1未使用 2已使用 3已过期）</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第多少页</td>
</tr>
<tr>
<td style="text-align: left;">limit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>每页多少条</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;1&quot;,
&quot;msg&quot;: &quot;获取成功&quot;,
&quot;data&quot;: [{
&quot;id&quot;: 880,
&quot;user_id&quot;: 100,
&quot;status&quot;: 1,
&quot;failure_time&quot;: &quot;2023-12-30 23:59:59&quot;,
&quot;remark&quot;: &quot;&quot;,
&quot;coupon_name&quot;: &quot;99减50元通用券&quot;,
&quot;coupon_type&quot;: 1,
&quot;user_phone&quot;: &quot;18600000001&quot;,
&quot;less_money&quot;: 50,
&quot;min_money&quot;: 99,
}
]
}</code></pre>
<h5>失败返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;-999&quot;,
&quot;msg&quot;: &quot;拒绝访问：你没有权限&quot;,
&quot;data&quot;: &quot;&quot;
}</code></pre>
<h5>返回参数说明</h5>
<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;">state</td>
<td style="text-align: left;">string</td>
<td>状态 1为成功，其他为失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>接口返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>数据域</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">data中的参数名</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;">user_id</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>状态（1未使用 2已使用 3已过期）</td>
</tr>
<tr>
<td style="text-align: left;">failure_time</td>
<td style="text-align: left;">datetime</td>
<td>失效时间</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">coupon_name</td>
<td style="text-align: left;">string</td>
<td>优惠券名称</td>
</tr>
<tr>
<td style="text-align: left;">coupon_type</td>
<td style="text-align: left;">string</td>
<td>优惠券类型（1通用券 2商品券 3分类券）</td>
</tr>
<tr>
<td style="text-align: left;">user_phone</td>
<td style="text-align: left;">string</td>
<td>用户手机号</td>
</tr>
<tr>
<td style="text-align: left;">less_money</td>
<td style="text-align: left;">decimal</td>
<td>优惠券面值</td>
</tr>
<tr>
<td style="text-align: left;">min_money</td>
<td style="text-align: left;">decimal</td>
<td>优惠券最低消费</td>
</tr>
</tbody>
</table>
<h5>错误代码</h5>
<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;">1</td>
<td style="text-align: left;">string</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td style="text-align: left;">string</td>
<td>参数有误</td>
</tr>
<tr>
<td style="text-align: left;">-99</td>
<td style="text-align: left;">string</td>
<td>异常</td>
</tr>
<tr>
<td style="text-align: left;">-999</td>
<td style="text-align: left;">string</td>
<td>拒绝访问：你没有权限</td>
</tr>
<tr>
<td style="text-align: left;">-9999</td>
<td style="text-align: left;">string</td>
<td>token验证失败</td>
</tr>
</tbody>
</table>