shopApi

商城API项目


商品详情

<h5>接口描述</h5> <ul> <li>商品详情</li> </ul> <h5>请求URL</h5> <ul> <li><code>api/admin/goods/{good}</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>REST 参数</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;">good</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>商品id</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;">include</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>包含额外的数据: category 分类,user 用户, comments 评论</td> </tr> </tbody> </table> <p>inlude可以返回额外的数据, 多个使用 , 分隔, 比如: include=category,user,comments</p> <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;">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;">category</td> <td style="text-align: left;">否</td> <td style="text-align: left;">object</td> <td>额外的 分类 数据,使用include才会返回</td> </tr> <tr> <td style="text-align: left;">user</td> <td style="text-align: left;">否</td> <td style="text-align: left;">object</td> <td>额外的 用户 数据,使用include才会返回</td> </tr> <tr> <td style="text-align: left;">comments</td> <td style="text-align: left;">否</td> <td style="text-align: left;">object</td> <td>额外的 评论 数数,使用include才会返回</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> <h5>返回示例</h5> <ul> <li>状态码 200 请求成功</li> </ul> <pre><code> { "id": 1, "category_id": 9, "description": "我的好衣服", "price": "32.00", "stock": 999, "pics": [ "3.png", "4.png" ], "pics_url": [ "https://show-api.oss-cn-hangzhou.aliyuncs.com//3.png", "https://show-api.oss-cn-hangzhou.aliyuncs.com//4.png" ], "cover": "HPTZiDQAZ8.jpg", "cover_url": "https://show-api.oss-cn-hangzhou.aliyuncs.com//HPTZiDQAZ8.jpg", "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": "贵人鸟" }, "comments": { "data": [ { "id": 1, "content": "真的好", "user_id": 1, "goods_id": 1, "rate": 1, "reply": "感谢购买", "pics": [ "3.png", "4.png" ], "pics_url": [ "https://show-api.oss-cn-hangzhou.aliyuncs.com//3.png", "https://show-api.oss-cn-hangzhou.aliyuncs.com//4.png" ], "created_at": "2021-09-10T07:11:27.000000Z", "updated_at": "2021-09-10T08:14:07.000000Z" } ] } }</code></pre>

页面列表

ITEM_HTML