商品列表
<h5>接口描述</h5>
<ul>
<li>商品列表</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/admin/goods</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </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;">Authorization</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>JWT token</td>
</tr>
</tbody>
</table>
<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;">current</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>分页-当前页</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;">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;">is_on</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>是否上架 0不上架 1上架</td>
</tr>
<tr>
<td style="text-align: left;">is_recommend</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>是否推荐 0不推荐 1推荐</td>
</tr>
<tr>
<td style="text-align: left;">include</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>包含额外的数据: category 分类,user 用户, comments 评论</td>
</tr>
</tbody>
</table>
<p><em>include可以返回数据,可以使用.号连接,比如:category.user</em></p>
<h5>返回参数</h5>
<p><strong>data</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;">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;">user_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>创建者</td>
</tr>
<tr>
<td style="text-align: left;">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;">title</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品标题</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>描述</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">decimal</td>
<td>价格</td>
</tr>
<tr>
<td style="text-align: left;">stock</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>库存</td>
</tr>
<tr>
<td style="text-align: left;">sales</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>销量</td>
</tr>
<tr>
<td style="text-align: left;">cover</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图</td>
</tr>
<tr>
<td style="text-align: left;">cover_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>封面图url</td>
</tr>
<tr>
<td style="text-align: left;">pics</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>小图集</td>
</tr>
<tr>
<td style="text-align: left;">pics_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>小图集url</td>
</tr>
<tr>
<td style="text-align: left;">is_on</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否上架 0不上架 1上架</td>
</tr>
<tr>
<td style="text-align: left;">is_recommend</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否推荐 0不推荐 1推荐</td>
</tr>
<tr>
<td style="text-align: left;">details</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>详情</td>
</tr>
<tr>
<td style="text-align: left;">created_at</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">timestamp</td>
<td>添加时间</td>
</tr>
<tr>
<td style="text-align: left;">updated_at</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">timestamp</td>
<td>更新时间</td>
</tr>
</tbody>
</table>
<p><strong>meta.pagination</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;">total</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>数据总数</td>
</tr>
<tr>
<td style="text-align: left;">count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前页数据</td>
</tr>
<tr>
<td style="text-align: left;">per_page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>每页显示条数</td>
</tr>
<tr>
<td style="text-align: left;">current_page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前页页码</td>
</tr>
<tr>
<td style="text-align: left;">total_pages</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>总页数</td>
</tr>
<tr>
<td style="text-align: left;">links.previous</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>上一页链接</td>
</tr>
<tr>
<td style="text-align: left;">links.next</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>下一页链接</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>状态码 200 请求成功</li>
</ul>
<pre><code> {
"data": [
{
"id": 1,
"category_id": 9,
"description": "我的好衣服",
"price": "32.00",
"stock": 999,
"pics": [
"3.png",
"4.png"
],
"cover": "/img/1.png",
"details": "我的好衣服我的好衣服我的好衣服",
"is_on": 0,
"is_recommend": 0,
"created_at": "2021-09-09T10:22:55.000000Z",
"updated_at": "2021-09-09T10:22:55.000000Z",
"category": {
"id": 9,
"name": "贵人鸟"
}
},
{
"id": 2,
"category_id": 9,
"description": "贵人鸟",
"price": "32.00",
"stock": 999,
"pics": [
"3.png",
"4.png"
],
"cover": "/img/1.png",
"details": "贵人鸟贵人鸟贵人鸟贵人鸟贵人鸟",
"is_on": 0,
"is_recommend": 0,
"created_at": "2021-09-09T10:23:29.000000Z",
"updated_at": "2021-09-09T10:23:29.000000Z",
"category": {
"id": 9,
"name": "贵人鸟"
}
}
],
"meta": {
"pagination": {
"total": 2,
"count": 2,
"per_page": 7,
"current_page": 1,
"total_pages": 1,
"links": null
}
}
}</code></pre>