订单记录列表
<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/order/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;">order_num</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
<tr>
<td style="text-align: left;">order_title</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品名称,模糊查询</td>
</tr>
<tr>
<td style="text-align: left;">order_status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单状态（1待付款 2已付款 3已发货 4已收货 5已取消 6退款中 7已退款 8拒绝退款 9已完成 10已评价）</td>
</tr>
<tr>
<td style="text-align: left;">order_time</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单时间 1=1个月 3=3个月 6=6个月 2022=2022整年</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;: 3270,
&quot;order_num&quot;: &quot;BL202312141018117385&quot;,
&quot;order_status&quot;: 0,
&quot;pay_way&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;add_time&quot;: &quot;2023-12-14T10:18:11&quot;,
&quot;express_name&quot;: &quot;圆通快递&quot;,
&quot;express_no&quot;: &quot;YT7479004171601&quot;,
&quot;sku_list&quot;: [
{
&quot;sub_id&quot;: 3269,
&quot;order_num&quot;: &quot;BL202312141018117385&quot;,
&quot;goods_id&quot;: 17,
&quot;rule_id&quot;: 17,
&quot;rule_value&quot;: &quot;4.0A&quot;,
&quot;goods_number&quot;: 1,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;goods_price&quot;: 65,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231202154930893.jpg&quot;
},
{
&quot;sub_id&quot;: 3269,
&quot;order_num&quot;: &quot;BL202312141018117385&quot;,
&quot;goods_id&quot;: 17,
&quot;rule_id&quot;: 18,
&quot;rule_value&quot;: &quot;5.2A&quot;,
&quot;goods_number&quot;: 1,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;goods_price&quot;: 90,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231202154934077.jpg&quot;
}
]
},
{
&quot;id&quot;: 3269,
&quot;order_num&quot;: &quot;BL202312141015106782&quot;,
&quot;order_status&quot;: 0,
&quot;pay_way&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;add_time&quot;: &quot;2023-12-14T10:15:10&quot;,
&quot;sku_list&quot;: [
{
&quot;sub_id&quot;: 3269,
&quot;order_num&quot;: &quot;BL202312141015106782&quot;,
&quot;rule_id&quot;: 18,
&quot;rule_value&quot;: &quot;5.2A&quot;,
&quot;goods_number&quot;: 15,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;goods_price&quot;: 90,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231202154934077.jpg&quot;
}
]
},
{
&quot;id&quot;: 3268,
&quot;order_num&quot;: &quot;BL202312141013550896&quot;,
&quot;order_status&quot;: 0,
&quot;pay_way&quot;: 1,
&quot;user_id&quot;: 100000,
&quot;add_time&quot;: &quot;2023-12-14T10:13:55&quot;,
&quot;sku_list&quot;: [
{
&quot;sub_id&quot;: 3269,
&quot;order_num&quot;: &quot;BL202312141013550896&quot;,
&quot;rule_id&quot;: 18,
&quot;rule_value&quot;: &quot;5.2A&quot;,
&quot;goods_number&quot;: 15,
&quot;goods_title&quot;: &quot;原装充电器 2.8A/4.0A/5.2A适配平台所有系列充电&quot;,
&quot;goods_price&quot;: 90,
&quot;spec_img&quot;: &quot;http://file.balin.com/goods/202312/20231202154934077.jpg&quot;
}
]
}
]
}</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;">order_num</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
<tr>
<td style="text-align: left;">order_status</td>
<td style="text-align: left;">int</td>
<td>订单状态（1待付款 2已付款 3已发货 4已收货 5已取消 6退款中 7已退款 8拒绝退款 9已完成 10已评价）</td>
</tr>
<tr>
<td style="text-align: left;">pay_way</td>
<td style="text-align: left;">int</td>
<td>支付方式（1app微信 2微信公众号 3微信小程序 4app支付宝 5H5支付宝 6零钱 7积分）</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;">add_time</td>
<td style="text-align: left;">datetime</td>
<td>订单时间</td>
</tr>
<tr>
<td style="text-align: left;">express_name</td>
<td style="text-align: left;">string</td>
<td>快递名称</td>
</tr>
<tr>
<td style="text-align: left;">express_no</td>
<td style="text-align: left;">string</td>
<td>订单号</td>
</tr>
<tr>
<td style="text-align: left;">sku_list</td>
<td style="text-align: left;">List<object></td>
<td>订单中的规格列表</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">sku_list参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">sub_id</td>
<td style="text-align: left;">int</td>
<td>子订单数据ID</td>
</tr>
<tr>
<td style="text-align: left;">order_num</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
<tr>
<td style="text-align: left;">goods_id</td>
<td style="text-align: left;">int</td>
<td>商品id</td>
</tr>
<tr>
<td style="text-align: left;">rule_id</td>
<td style="text-align: left;">int</td>
<td>规格id</td>
</tr>
<tr>
<td style="text-align: left;">rule_value</td>
<td style="text-align: left;">string</td>
<td>规格</td>
</tr>
<tr>
<td style="text-align: left;">goods_number</td>
<td style="text-align: left;">int</td>
<td>商品个数</td>
</tr>
<tr>
<td style="text-align: left;">goods_title</td>
<td style="text-align: left;">string</td>
<td>商品标题</td>
</tr>
<tr>
<td style="text-align: left;">goods_price</td>
<td style="text-align: left;">decimal</td>
<td>商品价格</td>
</tr>
<tr>
<td style="text-align: left;">spec_img</td>
<td style="text-align: left;">string</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>