券列表
<p><strong>请求URI:</strong></p>
<ul>
<li><code>/coupon</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>GET <code>AUTH</code></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;">used_switch</td>
<td style="text-align: left;">in:0,1</td>
<td style="text-align: left;">int</td>
<td>使用状态<br>0=未使用<br>1=已使用</td>
</tr>
<tr>
<td style="text-align: left;">bind_switch</td>
<td style="text-align: left;">in:0,1</td>
<td style="text-align: left;">int</td>
<td>绑定:0=否,1=是</td>
</tr>
<tr>
<td style="text-align: left;">start_datetime</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">datetime</td>
<td>开始时间 Y-m-d H:i:s</td>
</tr>
<tr>
<td style="text-align: left;">end_datetime</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">datetime</td>
<td>结束时间 Y-m-d H:i:s</td>
</tr>
<tr>
<td style="text-align: left;">role_type</td>
<td style="text-align: left;">in:0,1,2</td>
<td style="text-align: left;">int</td>
<td>自身角色类型<br>0=券拥有者角色(我拥有的券列表)<br>1=合作商角色(我购买分发的券列表)<br>2=核销者角色(我核销的券列表)</td>
</tr>
<tr>
<td style="text-align: left;">page_num</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">int</td>
<td>页码</td>
</tr>
<tr>
<td style="text-align: left;">limit_size</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">int</td>
<td>每页记录数</td>
</tr>
<tr>
<td style="text-align: left;">expiry_over</td>
<td style="text-align: left;">in:1</td>
<td style="text-align: left;">int</td>
<td>过期<br>1=是</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">length:32</td>
<td style="text-align: left;">string</td>
<td>订单号</td>
</tr>
<tr>
<td style="text-align: left;">goods_category_id</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">int</td>
<td>商品所属分类</td>
</tr>
<tr>
<td style="text-align: left;">abrogate_switch</td>
<td style="text-align: left;">in:0,1</td>
<td style="text-align: left;">int</td>
<td>作废:0=否,1=是</td>
</tr>
</tbody>
</table>
<pre><code>{
&quot;msg&quot;: &quot;请求成功&quot;,
&quot;data&quot;: {
&quot;total&quot;: 2,
&quot;per_page&quot;: 10,
&quot;current_page&quot;: 1,
&quot;last_page&quot;: 1,
&quot;data&quot;: [
{
&quot;abrogate_switch&quot;:0,//作废:0=否,1=是
&quot;grant_user_uuid&quot;:&quot;&quot;,//券直接下发人唯一值
&quot;alliance_user_info&quot;: {//合作商信息
&quot;alliance_name&quot;: &quot;合作商测试&quot;,
&quot;alliance_addr&quot;: &quot;321&quot;,
&quot;alliance_principal_name&quot;: &quot;&quot;,
&quot;alliance_principal_phone&quot;: &quot;&quot;
},
&quot;swap_user_info&quot;: {},//核销人信息
&quot;user_info&quot;: {//拥有者信息
&quot;user_uuid&quot;: &quot;cf740fb672bd4f56960819f2aa55d323&quot;,
&quot;user_name&quot;: &quot;只是&quot;,
&quot;user_icon&quot;: &quot;&quot;
},
&quot;id&quot;: 1498,
&quot;user_uuid&quot;: &quot;cf740fb672bd4f56960819f2aa55d323&quot;,
&quot;alliance_user_uuid&quot;: &quot;cf740fb672bd4f56960819f2aa55d322&quot;,//券所属合作商唯一值
&quot;order_no&quot;: &quot;24082313522289583000000000011281&quot;,
&quot;coupon_uuid&quot;: &quot;8a2aac21c422453fb14e64ed406e5a94&quot;,//券唯一值(使用时用该值)
&quot;bind_datetime&quot;: &quot;2024-08-23 14:02:05&quot;,//绑定时间
&quot;bind_uuid&quot;: &quot;3f8b8e280f7a4d4394669d82b386008f&quot;,//绑定唯一值(用户绑定时使用该值)
&quot;alliance_buy&quot;: 0,
&quot;used_switch&quot;: 0,//是否使用 0=否,1=是
&quot;goods_info&quot;: {//商品信息
&quot;id&quot;: 151,
&quot;type&quot;: 0,
&quot;alias&quot;: &quot;测试名称&quot;,
&quot;title&quot;: &quot;测试标题&quot;,
&quot;content&quot;: &quot;&lt;div&gt;123&lt;/div&gt;&quot;,
&quot;hot_switch&quot;: 0,
&quot;sale_price&quot;: 1,
&quot;category_id&quot;: 0,
&quot;cover_image&quot;: &quot;&quot;,
&quot;enable_switch&quot;: 1,
&quot;serveice_type&quot;: 0,
&quot;gen_qrcode_qty&quot;: 1,
&quot;original_price&quot;: 100,
&quot;brokerage_price&quot;: 8,
&quot;create_datetime&quot;: &quot;2024-08-20 13:57:40&quot;,
&quot;update_datetime&quot;: &quot;2024-08-23 13:14:18&quot;,
&quot;coupon_par_price&quot;: 121,
&quot;coupon_expiry_day&quot;: 1,
&quot;scanner_brokerage_price&quot;: 12
},
&quot;create_datetime&quot;: &quot;2024-08-23 14:02:05&quot;,
&quot;update_datetime&quot;: &quot;2024-08-26 09:28:35&quot;,
&quot;goods_id&quot;: 151,
&quot;expiry_datetime&quot;: &quot;0&quot;,//到期时间 为空则永久有效
&quot;bind_switch&quot;: 1,
&quot;used_datetime&quot;: &quot;&quot;,//使用时间
&quot;swap_user_uuid&quot;: &quot;&quot;,
&quot;par_price&quot;: 0//面值(分)
}
]
},
&quot;code&quot;: 0
}</code></pre>