bookShopApi

商城Api项目


商品列表

<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> <blockquote> <p>inlude可以返回额外的数据, 多个使用 <code>,</code> 分隔, 比如: <code>include=category,user,comments</code></p> </blockquote> <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;">int</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;">array</td> <td>小图集</td> </tr> <tr> <td style="text-align: left;">pics_url</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</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, "title": "电脑11111电脑", "category_id": 7, "description": "这是一个电脑1111", "price": 5000, "stock": 999, "sales": 2, "cover": "100x100.jpg", "cover_url": "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com/100x100.jpg", "pics": [ "a.png", "b.png" ], "pics_url": [ "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com/a.png", "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com/b.png" ], "details": "这是一个电脑这是一个电脑这是一个电脑这是一个电脑", "is_on": 1, "is_recommend": 1, "created_at": "2020-12-12T07:38:37.000000Z", "updated_at": "2020-12-12T10:13:45.000000Z" }, { "id": 2, "title": "电脑2", "category_id": 7, "description": "这是一个电脑", "price": 5000, "stock": 999, "sales": 2, "cover": "/imgs/img1.png", "cover_url": "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com//imgs/img1.png", "pics": [ "a.png", "b.png" ], "pics_url": [ "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com/a.png", "https://laravel-shop-api.oss-cn-beijing.aliyuncs.com/b.png" ], "details": "这是一个电脑这是一个电脑这是一个电脑这是一个电脑", "is_on": 0, "is_recommend": 0, "created_at": "2020-12-12T07:38:45.000000Z", "updated_at": "2020-12-12T07:38:45.000000Z" } ], "meta": { "pagination": { "total": 7, "count": 2, "per_page": 2, "current_page": 1, "total_pages": 4, "links": { "previous": null, "next": "http://api.test/api/admin/goods?page=2" } } } }</code></pre>

页面列表

ITEM_HTML