商品详情
<h5>接口描述</h5>
<ul>
<li>商品详情</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/goods/{good}</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</li>
</ul>
<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>返回参数</h5>
<p><strong>goods 商品详情</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;">collects_count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收藏人数</td>
</tr>
<tr>
<td style="text-align: left;">is_collect</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>
<tr>
<td style="text-align: left;">comments</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>关联的评论数据, 参考下表</td>
</tr>
</tbody>
</table>
<p><strong>goods.comments 商品评论</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;">goods_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;">order_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;">content</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>评论内容</td>
</tr>
<tr>
<td style="text-align: left;">rate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>价格</td>
</tr>
<tr>
<td style="text-align: left;">star</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>库存</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;">reply</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>
<tr>
<td style="text-align: left;">user</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>关联的用户数据, 参考下表</td>
</tr>
</tbody>
</table>
<p><strong>goods.comments.user 评论所关联的用户</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;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>用户名</td>
</tr>
<tr>
<td style="text-align: left;">avatar</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>头像</td>
</tr>
<tr>
<td style="text-align: left;">avatar_url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>头像地址</td>
</tr>
</tbody>
</table>
<p><strong>like_goods 相似商品</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;">title</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;">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;">collects_count</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收藏人数</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>状态码 200 请求成功</li>
</ul>
<pre><code>{
"goods": {
"id": 1,
"user_id": 1,
"category_id": 13,
"title": "Voluptas fugit ex.",
"description": "Culpa soluta omnis quod rerum ut aut.",
"price": 62333,
"stock": 9840,
"sales": 1,
"cover": "http://placeimg.com/640/480/any",
"pics": [
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any"
],
"is_on": 1,
"is_recommend": 1,
"details": "Aut accusamus adipisci nisi possimus corrupti id aperiam",
"created_at": "2020-12-22T02:58:34.000000Z",
"updated_at": "2020-12-22T10:24:50.000000Z",
"cover_url": "http://placeimg.com/640/480/any",
"pics_url": [
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any",
"http://placeimg.com/640/480/any"
],
"collects_count": 1,
"is_collect": 1,
"comments": [
{
"id": 1,
"user_id": 1,
"order_id": 1,
"goods_id": 1,
"rate": 1,
"star": 5,
"content": "不错",
"reply": null,
"pics": null,
"created_at": null,
"updated_at": null,
"user": {
"id": 1,
"name": "超级管理员",
"avatar": null,
"avatar_url": ""
}
}
]
},
"like_goods": [
{
"id": 105,
"title": "Doloribus rerum.",
"price": 13326,
"cover": "http://placeimg.com/640/480/any",
"sales": 0,
"cover_url": "http://placeimg.com/640/480/any",
"collects_count": 1,
}
]
}</code></pre>