列表
<h5>简要描述</h5>
<ul>
<li>商品列表接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/goods</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</li>
</ul>
<h5>Query 请求参数</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;">category_id </td>
<td style="text-align: left;"> 是 </td>
<td style="text-align: left;">int</td>
<td>商品分类id </td>
</tr>
<tr>
<td style="text-align: left;">title </td>
<td style="text-align: left;"> 否 </td>
<td style="text-align: left;">string</td>
<td>商品标题 </td>
</tr>
<tr>
<td style="text-align: left;">brand_id </td>
<td style="text-align: left;"> 否</td>
<td style="text-align: left;">int</td>
<td>商品品牌id </td>
</tr>
<tr>
<td style="text-align: left;">attr </td>
<td style="text-align: left;"> 否 </td>
<td style="text-align: left;">string</td>
<td>商品筛选属性,例如:<1_5G-3<em>触屏> 1是属性id,5G是属性值,使用“</em>”符号连接。“-”是商品属性之间的分割记号</td>
</tr>
<tr>
<td style="text-align: left;">sort </td>
<td style="text-align: left;"> 否 </td>
<td style="text-align: left;">string</td>
<td>排序,例如:price-desc,意思是价格降序,price-asc是价格升序,可选值:[sales, comments_count, new, price] </td>
</tr>
<tr>
<td style="text-align: left;">price_range </td>
<td style="text-align: left;"> 否 </td>
<td style="text-align: left;">string</td>
<td>价格范围,例如:2000-8000 ,如果用户填写的第一个价格比第二价格高,价格位置需要互换</td>
</tr>
<tr>
<td style="text-align: left;">limit </td>
<td style="text-align: left;"> 否 </td>
<td style="text-align: left;">int</td>
<td>条数 </td>
</tr>
</tbody>
</table>
<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;">categorys</td>
<td style="text-align: left;"> 是 </td>
<td style="text-align: left;">array</td>
<td>商品分类 </td>
</tr>
<tr>
<td style="text-align: left;">goodsAttrScreen</td>
<td style="text-align: left;"> 是 </td>
<td style="text-align: left;">obj</td>
<td>商品属性,筛选使用</td>
</tr>
<tr>
<td style="text-align: left;">goods</td>
<td style="text-align: left;"> 是 </td>
<td style="text-align: left;">obj</td>
<td>商品列表数据,含有分页数据</td>
</tr>
<tr>
<td style="text-align: left;">recommend_goods</td>
<td style="text-align: left;"> 是 </td>
<td style="text-align: left;">array</td>
<td>推荐商品</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>状态码 200 请求成功</li>
</ul>
<pre><code>{
&quot;categorys&quot;: [
{
&quot;id&quot;: 1,
&quot;parent_id&quot;: 0,
&quot;name&quot;: &quot;家用电器&quot;,
&quot;level&quot;: 1,
&quot;children&quot;: [
{
&quot;id&quot;: 2,
&quot;parent_id&quot;: 1,
&quot;name&quot;: &quot;大家电&quot;,
&quot;level&quot;: 2,
&quot;children&quot;: [
{
&quot;id&quot;: 3,
&quot;parent_id&quot;: 2,
&quot;name&quot;: &quot;冰箱&quot;,
&quot;level&quot;: 3
},
{
&quot;id&quot;: 4,
&quot;parent_id&quot;: 2,
&quot;name&quot;: &quot;空调&quot;,
&quot;level&quot;: 3
},
{
&quot;id&quot;: 5,
&quot;parent_id&quot;: 2,
&quot;name&quot;: &quot;平板电视&quot;,
&quot;level&quot;: 3
}
]
},
.........
}
],
&quot;goodsAttrScreen&quot;: {
&quot;品牌&quot;: [
{
&quot;value&quot;: &quot;全部&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 1
},
{
&quot;brand_id&quot;: 1,
&quot;value&quot;: &quot;Apple&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;brand_id&quot;: 2,
&quot;value&quot;: &quot;小米&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;brand_id&quot;: 3,
&quot;value&quot;: &quot;华为&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 0
}
],
&quot;网络制式&quot;: [
{
&quot;value&quot;: &quot;全部&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;attribute_id&quot;: 1,
&quot;value&quot;: &quot;5G&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/3_%E8%A7%A6%E5%B1%8F-1_5G/new-desc/20&quot;,
&quot;selected&quot;: 1
},
{
&quot;attribute_id&quot;: 1,
&quot;value&quot;: &quot;4G/5G&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/3_%E8%A7%A6%E5%B1%8F-1_4G%2F5G/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;attribute_id&quot;: 1,
&quot;value&quot;: &quot;4G&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/3_%E8%A7%A6%E5%B1%8F-1_4G/new-desc/20&quot;,
&quot;selected&quot;: 0
}
],
&quot;尺寸/体积&quot;: [
{
&quot;value&quot;: &quot;全部&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 1
},
{
&quot;attribute_id&quot;: 2,
&quot;value&quot;: &quot;6.9寸&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F-2_6.9%E5%AF%B8/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;attribute_id&quot;: 2,
&quot;value&quot;: &quot;6.1寸&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F-2_6.1%E5%AF%B8/new-desc/20&quot;,
&quot;selected&quot;: 0
}
],
&quot;外观样式/手机类型&quot;: [
{
&quot;value&quot;: &quot;全部&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G/new-desc/20&quot;,
&quot;selected&quot;: 0
},
{
&quot;attribute_id&quot;: 3,
&quot;value&quot;: &quot;触屏&quot;,
&quot;url&quot;: &quot;http://api.ying.com/api/goods/11/1_5G-3_%E8%A7%A6%E5%B1%8F/new-desc/20&quot;,
&quot;selected&quot;: 1
}
]
},
&quot;goods&quot;: {
&quot;current_page&quot;: 1,
&quot;data&quot;: [
{
&quot;id&quot;: 5,
&quot;category_id&quot;: 11,
&quot;brand_id&quot;: 2,
&quot;title&quot;: &quot;Redmi K60手机红米k60红米小米手机&quot;,
&quot;cover&quot;: &quot;http://placeimg.com/480/480/any&quot;,
&quot;market_price&quot;: &quot;2299.00&quot;,
&quot;shop_price&quot;: &quot;2099.00&quot;,
&quot;stock&quot;: 200,
&quot;sales&quot;: 0,
&quot;comments_count&quot;: 0,
&quot;cover_url&quot;: &quot;http://placeimg.com/480/480/any&quot;
},
{
&quot;id&quot;: 1,
&quot;category_id&quot;: 11,
&quot;brand_id&quot;: 1,
&quot;title&quot;: &quot;Apple/苹果 iPhone 15&quot;,
&quot;cover&quot;: &quot;storage/images/20230606/DnSrquiI4BT1m5Ug0aFkiLaim8rO6fcDubwxqeSN.png&quot;,
&quot;market_price&quot;: &quot;6599.00&quot;,
&quot;shop_price&quot;: &quot;5599.00&quot;,
&quot;stock&quot;: 150,
&quot;sales&quot;: 0,
&quot;comments_count&quot;: 0,
&quot;cover_url&quot;: &quot;storage/images/20230606/DnSrquiI4BT1m5Ug0aFkiLaim8rO6fcDubwxqeSN.png&quot;
}
],
&quot;first_page_url&quot;: &quot;http://api.ying.com/api/goods?page=1&quot;,
&quot;from&quot;: 1,
&quot;next_page_url&quot;: null,
&quot;path&quot;: &quot;http://api.ying.com/api/goods&quot;,
&quot;per_page&quot;: &quot;20&quot;,
&quot;prev_page_url&quot;: null,
&quot;to&quot;: 2
},
&quot;recommend_goods&quot;: [
{
&quot;id&quot;: 4,
&quot;title&quot;: &quot;HUAWEI/华为Mate 50 直屏超光变XMAGE影像鸿蒙3.0拍照摄影游戏新款智能手机&quot;,
&quot;cover&quot;: &quot;http://placeimg.com/480/480/any&quot;,
&quot;shop_price&quot;: &quot;4299.00&quot;,
&quot;comments_count&quot;: 0,
&quot;cover_url&quot;: &quot;http://placeimg.com/480/480/any&quot;
},
{
&quot;id&quot;: 3,
&quot;title&quot;: &quot;Apple/苹果 iPhone 12&quot;,
&quot;cover&quot;: &quot;storage/images/20230606/DnSrquiI4BT1m5Ug0aFkiLaim8rO6fcDubwxqeSN.png&quot;,
&quot;shop_price&quot;: &quot;4699.00&quot;,
&quot;comments_count&quot;: 0,
&quot;cover_url&quot;: &quot;storage/images/20230606/DnSrquiI4BT1m5Ug0aFkiLaim8rO6fcDubwxqeSN.png&quot;
},
........
]
}</code></pre>