购物中心商城商品列表
<h3>商品列表</h3>
<h5>简要描述</h5>
<ul>
<li>获取商品列表数据</li>
</ul>
<h5>请求url</h5>
<ul>
<li>
<pre><code>https://www.商城域名.com/index.php?s=/api/goods/list</code></pre>
</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</li>
</ul>
<h5>是否需授权登录</h5>
<ul>
<li>否</li>
</ul>
<h5>请求header</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>是否必须</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>storeId</td>
<td>int</td>
<td>必填</td>
<td>10001</td>
<td>商城ID 10001京东 10002商品定制 10003进口商品 10004企业采购</td>
</tr>
<tr>
<td>platform</td>
<td>string</td>
<td>必填</td>
<td>H5</td>
<td>当前请求的客户端（APP、小程序、H5等）</td>
</tr>
<tr>
<td>Access-Token</td>
<td>string</td>
<td>选填</td>
<td>-</td>
<td>当前登录用户的 Token</td>
</tr>
</tbody>
</table>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>是否必须</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>categoryId</td>
<td>int</td>
<td>选填</td>
<td>-</td>
<td>商品分类ID</td>
</tr>
<tr>
<td>goodsName</td>
<td>string</td>
<td>选填</td>
<td>-</td>
<td>商品名称 (用于搜索)</td>
</tr>
<tr>
<td>goodsNo</td>
<td>string</td>
<td>选填</td>
<td>-</td>
<td>商品编码</td>
</tr>
<tr>
<td>sortType</td>
<td>string</td>
<td>选填</td>
<td>all</td>
<td>排序类型 (all默认 sales销量 price价格)</td>
</tr>
<tr>
<td>sortPrice</td>
<td>boolean</td>
<td>选填</td>
<td>true</td>
<td>价格排序 (true高到低 false低到高)</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
"status": 200,
"message": "success",
"data": {
"list": {
"total": 2,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"goods_sales": 363,
"goods_id": 10007,
"goods_name": "小米6X 全网通 4GB+32GB 流沙金 移动联通电信4G手机 双卡双待 智能手机",
"goods_no": "",
"video_id": 0,
"video_cover_id": 0,
"selling_point": "",
"spec_type": 20,
"goods_price_min": "1302",
"goods_price_max": "1602",
"line_price_min": "00",
"line_price_max": "00",
"stock_total": 1994,
"delivery_id": 10001,
"is_points_gift": 1,
"is_points_discount": 1,
"is_alone_points_discount": 0,
"points_discount_config": "",
"is_enable_grade": 1,
"is_alone_grade": 0,
"alone_grade_equity": [],
"status": 10,
"is_ind_dealer": 0,
"dealer_money_type": 10,
"first_money": "00",
"second_money": "00",
"third_money": "00",
"goods_image": "http://static.yoshop.xanycom/2018071716542894aea94jpg",
"is_user_grade": true
}
]
}
}
}</code></pre>
<h5>返回参数</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>status</td>
<td>int</td>
<td>200</td>
<td>请求状态（200：请求成功；500：请求错误/失败）</td>
</tr>
<tr>
<td>message</td>
<td>string</td>
<td>success</td>
<td>请求结果的信息，默认为 success</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>-</td>
<td>返回的业务数据</td>
</tr>
</tbody>
</table>
<h5>data 参数</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>list</td>
<td>object</td>
<td>-</td>
<td>列表数据</td>
</tr>
</tbody>
</table>
<h5>data.list 参数</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>total</td>
<td>int</td>
<td>2</td>
<td>总记录数</td>
</tr>
<tr>
<td>per_page</td>
<td>int</td>
<td>15</td>
<td>每页记录数</td>
</tr>
<tr>
<td>current_page</td>
<td>int</td>
<td>1</td>
<td>当前页码</td>
</tr>
<tr>
<td>last_page</td>
<td>int</td>
<td>1</td>
<td>最后页码</td>
</tr>
<tr>
<td>data</td>
<td>array</td>
<td>-</td>
<td>列表数组</td>
</tr>
</tbody>
</table>
<h5>data.list.data 参数</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>goods_sales</td>
<td>int</td>
<td>363</td>
<td>显示销量 (初始销量 + 实际销量)</td>
</tr>
<tr>
<td>goods_id</td>
<td>int</td>
<td>10007</td>
<td>商品ID</td>
</tr>
<tr>
<td>goods_name</td>
<td>string</td>
<td>小米6X 全网通4G+32G....</td>
<td>商品名称</td>
</tr>
<tr>
<td>goods_no</td>
<td>string</td>
<td>-</td>
<td>商品编码</td>
</tr>
<tr>
<td>video_id</td>
<td>int</td>
<td>-</td>
<td>主图视频ID</td>
</tr>
<tr>
<td>video_cover_id</td>
<td>int</td>
<td>-</td>
<td>主图视频封面ID</td>
</tr>
<tr>
<td>selling_point</td>
<td>string</td>
<td>-</td>
<td>商品卖点</td>
</tr>
<tr>
<td>spec_type</td>
<td>int</td>
<td>20</td>
<td>商品规格 (10单规格 20多规格)</td>
</tr>
<tr>
<td>goods_price_min</td>
<td>string</td>
<td>1371.02</td>
<td>商品价格 (最低)</td>
</tr>
<tr>
<td>goods_price_max</td>
<td>string</td>
<td>1665.02</td>
<td>商品价格 (最高)</td>
</tr>
<tr>
<td>line_price_min</td>
<td>string</td>
<td>0.00</td>
<td>划线价格 (最低)</td>
</tr>
<tr>
<td>line_price_max</td>
<td>string</td>
<td>0.00</td>
<td>划线价格 (最高)</td>
</tr>
<tr>
<td>stock_total</td>
<td>int</td>
<td>1994</td>
<td>库存总量 (包含所有sku)</td>
</tr>
<tr>
<td>delivery_id</td>
<td>int</td>
<td>10001</td>
<td>配送模板ID</td>
</tr>
<tr>
<td>is_points_gift</td>
<td>int</td>
<td>1</td>
<td>是否开启积分赠送 (1开启 0关闭)</td>
</tr>
<tr>
<td>is_points_discount</td>
<td>int</td>
<td>1</td>
<td>是否允许使用积分抵扣 (1允许 0不允许)</td>
</tr>
<tr>
<td>is_enable_grade</td>
<td>int</td>
<td>1</td>
<td>是否开启会员折扣 (1开启 0关闭)</td>
</tr>
<tr>
<td>is_alone_grade</td>
<td>int</td>
<td>-</td>
<td>会员折扣设置 (0默认等级折扣 1单独设置折扣)</td>
</tr>
<tr>
<td>alone_grade_equity</td>
<td>array</td>
<td>-</td>
<td>单独设置折扣的配置</td>
</tr>
<tr>
<td>status</td>
<td>int</td>
<td>10</td>
<td>商品状态 (10上架 20下架)</td>
</tr>
<tr>
<td>is_ind_dealer</td>
<td>int</td>
<td>-</td>
<td>是否开启单独分销 (0关闭 1开启)</td>
</tr>
<tr>
<td>dealer_money_type</td>
<td>int</td>
<td>10</td>
<td>分销佣金类型 (10百分比 20固定金额)</td>
</tr>
<tr>
<td>first_money</td>
<td>string</td>
<td>0.00</td>
<td>分销佣金 (一级)</td>
</tr>
<tr>
<td>second_money</td>
<td>string</td>
<td>0.00</td>
<td>分销佣金 (二级)</td>
</tr>
<tr>
<td>third_money</td>
<td>string</td>
<td>0.00</td>
<td>分销佣金 (三级)</td>
</tr>
<tr>
<td>goods_image</td>
<td>string</td>
<td>2018071716542894aea9466.jpg</td>
<td>商品主图url</td>
</tr>
<tr>
<td>is_user_grade</td>
<td>boolean</td>
<td>true</td>
<td>是否使用会员等级折扣价（判断登录用户的会员等级）</td>
</tr>
</tbody>
</table>